|
|
Paraslash Audio Streaming |
| About News Download Documentation Development |
Development happens in topic branches where each topic corresponds to one branch. Each topic branch is merged into either of two integration branches named next and pu ("proposed updates"). The integration branches are pushed to the public repository but the topic branches are not.
Topics in early development are only merged into the pu integration branch. When the topic is feature-complete, has been tested, has no known bugs, and is fully documented, it graduates to next. Thus, topics in next are expected to be of higher quality than those in pu.
When a topic is ready for mainline, it is merged into the master integration branch and vanishes from here, since it is no longer considered as being in development. Since releases are cut from master, the commits of the topic will become part of the next release. Maintenance releases are drawn from the maint integration branch in a similar vein.
No development takes place on master and maint but the two special topic branches misc and for-maint collect small commits aiming for master and maint, respectively. The for-maint branch only receives important fixes.
The table below shows the current development topics. Run git
checkout pu to get all topics or git checkout next
to enable only the mature topics.
| Topic | IB | #C | Description |
|---|---|---|---|
| afs-ls-a | next | 5 | ls: Allow for an optional argument to -a |
| afs-select | next | 1 | Implement --verbose for com_select() |
| btr | pu | 5 | buffer tree subsystem speedups |
| build | pu | 20 | Improvements for the build system |
| crypt-cleanups | next | 8 | Trivial cleanups for the crypto code |
| for-maint | pu | 0 | Urgent fixes for old bugs |
| ls-L | next | 1 | Implement --limit for com_ls() |
| misc | pu | 8 | Smallish changes for master |
| openssl-3 | pu | 10 | Convert openssl code to EVP |
| play | pu | 6 | Improvements for para_play |
| sf_float | pu | 1 | Support 32 bit float sample format |
The SHA1 number shown as tip can be used to checkout a commit which only contains the changes introduced in this topic.
A new feature for the ls command. Unfortunately, several bugs were found after the topic graduated to next, so the series contains a few fixup commits on top of the single patch which implements the feature.
afs.c | 14 +++----
afs.h | 18 +++++---
aft.c | 47 ++++++++++++++++++---
m4/lls/server_cmd.suite.m4 | 14 ++++++-
mood.c | 102 +++++++++++++++++++++++++++++++++------------
playlist.c | 98 +++++++++++++++++++++++++++++++++----------
score.c | 82 ++++++++++++++++++++++++------------
7 files changed, 280 insertions(+), 95 deletions(-)
A single patch which silences the select command.
afs.c | 9 ++++++---
m4/lls/server_cmd.suite.m4 | 3 +++
mood.c | 5 ++++-
3 files changed, 13 insertions(+), 4 deletions(-)
Some helpers such as btr_get_input_queue_size() are very expensive if the buffer tree contains many buffers, which is the case for mp3 and aac streams. This is noticeable in particular with para_play, which spends more time in the btr subsystem than in the mp3 decoder if the file is large enough. This branch contains a few patches to improve that.
aacdec_filter.c | 3 +-
afh_recv.c | 2 +-
buffer_tree.c | 118 ++++++++++++++++++++++++++++++++++++------------------
buffer_tree.h | 80 ++++++++++++++++++------------------
check_wav.c | 2 +-
flacdec_filter.c | 2 +-
list.h | 2 +
mp3dec_filter.c | 10 ++---
oggdec_filter.c | 3 +-
opusdec_filter.c | 2 +-
resample_filter.c | 3 +-
spxdec_filter.c | 2 +-
wmadec_filter.c | 3 +-
13 files changed, 138 insertions(+), 94 deletions(-)
Started on 2023-06-21
This series simplifies the build system quite a bit. The bulk of the series consists of the commits which move the logic to construct the object list of the paraslash executables from configure.ac to Makefile.real.
Makefile.in | 31 ++--
Makefile.real | 266 ++++++++++++++++++++++++++-
audiod.c | 5 +-
audiod.h | 7 -
configure.ac | 547 +++-----------------------------------------------------
openssl.c | 3 -
t/makefile.test | 2 +-
t/t0005-man.sh | 11 +-
8 files changed, 310 insertions(+), 562 deletions(-)
This bunch of mostry trivial changes can be merged early, before the openssl code is converted to use the EVP API.
<!--
- Cleanup of the openssl-specific code.
-->
client_common.c | 13 ++++++++-----
gcrypt.c | 4 ----
openssl.c | 34 +++++++++++++++-------------------
user_list.c | 2 +-
4 files changed, 24 insertions(+), 29 deletions(-)
This branch accumulates small but significant hotfixes for known bugs in the most stable integration branch, “maint”. Only serious issues are fixed here, and no development takes place on this branch.
The purpose of the branch is to give such urgent fixes at least a small amount of testing in pu before they are incorporated into maint. During this time the patch can be tweaked, and the documentation can be improved. Usually the commits of this branch are merged quickly, however, and it it perfectly normal if this branch is empty.
A single patch which implements the new –limit option for the ls server command.
aft.c | 28 ++++++++++++----------------
m4/lls/server_cmd.suite.m4 | 10 ++++++++++
2 files changed, 22 insertions(+), 16 deletions(-)
The stuff in here is too small to get its own topic branch. The commits are generally regarded as safe enough to be applied directly to “master” without cooking in “next” first. However, if a commit induces a merge conflict or is important enough to get mentioned in an item of the NEWS file, the commit should get a dedicated topic branch.
Unlike most other topic branches, this branch never promotes to “next”. When a set of commits is ready to graduate to “master”, the branch is rebased onto “master” and its commits are re-ordered so that the graduating commits appear at the beginning. The last such commit is merged to “master”. This always results in a fast-forward merge, so no merge message needs to be supplied.
Makefile.real | 1 +
audiod.c | 2 +-
audiod.h | 2 +-
audiod_command.c | 21 +++++++--------------
command.c | 14 +++-----------
gui.c | 1 +
gui_theme.c | 2 +-
interactive.c | 1 +
mp4.c | 2 +-
mp4.h | 2 +-
net.c | 2 +-
net.h | 2 +-
ogg_afh_common.c | 2 +-
ogg_afh_common.h | 2 +-
send.h | 4 ++--
send_common.c | 4 ++--
string.c | 31 +++++++++++++++++++++++--------
17 files changed, 49 insertions(+), 46 deletions(-)
Started on 2023-04-29.
The series starts with a few cleanups and crypto-backend tweaks to beat the openssl specific code into shape for the main objective: the switch of the RSA encryption and decryption routines to the high-level EVP API. This has become necessary because the old RSA API functions have been deprecated in openssl-3.
Makefile.real | 1 -
client_common.c | 10 +-
command.c | 15 ++-
configure.ac | 5 +
crypt.h | 8 +-
error.h | 2 +-
gcrypt.c | 25 +++-
openssl.c | 393 +++++++++++++++++++++++++++++++++++++-------------------
8 files changed, 303 insertions(+), 156 deletions(-)
This small series contains a few minor tweaks for para_play. The most obvious change is that para_play is no longer built on systems which lack libreadline.
audiod.c | 7 ++-
configure.ac | 149 +++++++++++++++++++++++++++++---------------------------
filter.c | 6 ++-
filter_common.c | 17 +++----
play.c | 120 ++++++++++++---------------------------------
t/t0005-man.sh | 11 +++--
web/manual.md | 7 +--
7 files changed, 139 insertions(+), 178 deletions(-)
A single patch which adds two new sample formats for 32 bit IEEE float waveform data.
alsa_write.c | 2 ++
ao_write.c | 2 ++
check_wav.c | 20 +++++++++++++++++---
m4/lls/include/sample-format.m4 | 4 +++-
para.h | 2 ++
5 files changed, 26 insertions(+), 4 deletions(-)