|
|
Paraslash Audio Streaming |
| About News Download Documentation Development |
Most of the development happens in topic branches where each development topic corresponds to one git 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.
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 |
|---|---|---|---|
| build | next | 10 | Improvements to the build system |
| com_attr | pu | 1 | Supersede com_setatt() |
| completion | pu | 5 | Improved tab completion |
| misc | pu | 6 | Smallish changes for master |
| select- | next | 1 | com_select(): Support the special argument "-" |
| wmadec | next | 3 | Improvements to the wma decoder |
Pass the hash value shown as sha1 below to git
checkout to check out one particular topic branch.
Started on 2025-01-19
A medium sized branch which improves the build system, specifially how the git version is incorporated into the man pages and the –version output. Subsequent patches of the series remove some warts from the makefile: we no longer use order-only dependencies and the .PRECIOUS target.
.gitignore | 1 -
GIT-VERSION-GEN | 42 -----------------------
Makefile.real | 99 ++++++++++++++++++++++++++---------------------------
afh.c | 1 -
audioc.c | 1 -
audiod.c | 1 -
audiod_command.c | 1 -
client.c | 1 -
client_common.c | 1 -
command.c | 1 -
configure.ac | 2 +-
filter.c | 1 -
gui.c | 1 -
m4/lls/copyright.m4 | 28 ++++++++++++---
m4/lls/makefile | 7 ++--
mixer.c | 1 -
oggdec_filter.c | 10 ++++++
play.c | 1 -
recv.c | 1 -
server.c | 1 -
string.c | 53 ++++++++++++++++++++++++++++
string.h | 26 ++++++++++++++
upgrade_db.c | 1 -
version-gen.sh | 43 +++++++++++++++++++++++
version.c | 69 -------------------------------------
version.h | 5 ---
write.c | 1 -
yy/makefile | 7 ++--
28 files changed, 210 insertions(+), 197 deletions(-)
A single patch which adds a new subcommand that deprecates com_setatt() because its syntax was poorly designed. For example, it fails if the name of an audio file happens to end in ‘+’ or ‘-’.
Started on 2025-03-17
aft.c | 86 +++++++++++++++++++++++++++++++++++++++++++++-
client.c | 9 +++++
m4/lls/server_cmd.suite.m4 | 53 +++++++++++++++++++++++-----
3 files changed, 139 insertions(+), 9 deletions(-)
The completers for para_client and para_audioc handle some cases incorrectly or not at all. This series tries to improve on that.
Started on 2025-04-07.
audioc.c | 21 +++++++--
bash_completion | 122 ++++++++++++++++++++++++-----------------------
client.c | 143 +++++++++++++++++++++++++++++++++++++-------------------
interactive.c | 119 +++++++++++++++++++++++++++++++++++++++++++---
interactive.h | 8 ++--
play.c | 2 +-
6 files changed, 294 insertions(+), 121 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.
afs.c | 75 ++++++++++++++++++++++---------------------------------
audiod_command.c | 8 +++---
blob.c | 16 ++++++------
command.c | 13 ++++++----
lsu.c | 26 +++++++++----------
mp3_afh.c | 28 +++++++++++++++++++++
play.c | 12 ++++++---
playlist.c | 38 ++++++++++++++++------------
web/about.in.html | 1 +
9 files changed, 122 insertions(+), 95 deletions(-)
A single patch which implements the new feature.
Started on 2024-11-30, cooking since 2025-04-19.
afs.c | 34 +++++++++++++++++++++++++---------
m4/lls/server_cmd.suite.m4 | 8 +++++---
2 files changed, 30 insertions(+), 12 deletions(-)
Started on 2025-01-22
A few patches which remove unused code from the wma decoder and audio format handler. Notably, noise coding was removed completely since it was only used for unusual bit rates. Most likely, it never worked in the first place.
imdct.c | 17 ++---
wmadata.h | 16 -----
wmadec_filter.c | 211 +++++---------------------------------------------------
3 files changed, 23 insertions(+), 221 deletions(-)