[9front] [patch] juke documentation

[9front] [patch] juke documentation

[Romano]

[-- Attachment #1: Type: text/plain, Size: 167 bytes --]

Attached is a patch to fixup some of the juke documentation.  If this
should go to some other mailing list (9front-bugs?), let me know, or
if there are issues with it.

[-- Attachment #2: Type: text/plain, Size: 1504 bytes --]

changeset:   8399:975eb801a5c7
branch:      mbp-2011
user:        Romano <unobe@cpan.org>
date:        Thu Apr 08 01:16:57 2021 -0700
summary:     Fix discrepancies between juke, its documentation, and what is on the ISO. /bin/rc/juke uses the name 'classical', but that is not an actual command, and 'hg diff' always shows the difference on a clean install. Additionally, some of the flags were not shown on the 'usage:' line and were not described in the man page.

diff -r cd9b2ab05bca -r 975eb801a5c7 sys/man/7/juke
--- a/sys/man/7/juke	Thu Apr 08 01:00:19 2021 -0700
+++ b/sys/man/7/juke	Thu Apr 08 01:16:57 2021 -0700
@@ -4,6 +4,10 @@
 .SH SYNOPSIS
 .B juke
 [
+.B \-d
+.I level
+]
+[
 .B \-t
 ]
 [
@@ -143,8 +147,14 @@
 the window in which it is invoked.
 .PP
 The
+.B \-h
+flag is used with
 .B \-s
-flag specifies the name under which the file descriptors of the playlist and databse servers are posted
+to specify the play list host which is serving the playlist.
+.PP
+The
+.B \-s
+flag specifies the name under which the file descriptors of the playlist and database servers are posted
 in /srv.  This allows two or more play list servers to exist on one platform, e.g., when
 there are several audio devices.  The default value of the flag is
 .B $\f2user\fP
@@ -152,6 +162,12 @@
 .B /srv/playlistfs.$\f2user\fP
 and a database server at
 .BR /srv/jukefs.$\f2user\fP .
+.PP
+The
+.B \-d
+flag is used to specify the debug level for debugging the
+.I juke
+shell script.
 .sp
 .LP
 .B Jukefs

Re: [9front] [patch] juke documentation

[Sigrid Solveig Haflínudóttir]

Maybe we should just remove juke.  Does *anyone* use it?  How?  Why?

Re: [9front] [patch] juke documentation

[Romano]

I do not use it, but my impetus for the patch was to address the 'hg status' on tip--I was annoyed that juke was always shown as modified even tho' I didn't do anything to it. That led me to address the docs. I don't have a dog in the fight for if it should stay or go. I will want to play music at some point (and probably playlists), but there are probably other methods to use (e.g. play(1) + some-other-glue).

On April 8, 2021 7:46:30 PM UTC, "Sigrid Solveig Haflínudóttir" <ftrvxmtrx@gmail.com> wrote:
>Maybe we should just remove juke.  Does *anyone* use it?  How?  Why?

Re: [9front] [patch] juke documentation

[umbraticus]

> there are probably other methods to use (e.g. play(1) + some-other-glue).

indeed: http://nopenopenope.net/posts/play

see also: https://git.sr.ht/~ft/zuke

Re: [9front] [patch] juke documentation

[kvik]

Quoth Romano <unobe@cpan.org>:
> the 'hg status' on tip

I recently noticed that as well and found what's causing the issue.

In 7613:721c15f31836 henesy went through the commands and did a number
of cleanups.  However, he failed to notice that /rc/bin/juke isn't a
dist file and is instead being installed by the mkfile from
/sys/src/cmd/games/music.

So now we have two copies of this file, with the original having a
wrong usage message and causing hg status to show it after mk install.

I think we just remove the juke.rc and the mkfile rules to fix this.

I also think we just nuke the juke and replace it with sigrid's zuke.

Re: [9front] [patch] juke documentation

[Noam Preil]

Controversial proposal: remove juke, merge in zuke instead

Re: [9front] [patch] juke documentation

[Jacob Moody]

On 4/8/21 3:16 PM, kvik@a-b.xyz wrote:
> I also think we just nuke the juke and replace it with sigrid's zuke.
> 

I think this would probably be for the best. Unless some juke users
come out of the woodwork here I haven't heard of anyone using it.

Re: [9front] [patch] juke documentation

[hiro]

juke is totally broken i doubt anybody could be using it

On 4/9/21, Jacob Moody <moody@mail.posixcafe.org> wrote:
> On 4/8/21 3:16 PM, kvik@a-b.xyz wrote:
>> I also think we just nuke the juke and replace it with sigrid's zuke.
>>
>
> I think this would probably be for the best. Unless some juke users
> come out of the woodwork here I haven't heard of anyone using it.
>

Re: [9front] [patch] juke documentation

[cinap_lenrek]

yeah, i agree it is better to replace it with something maintained.

in-tree or off tree... as you prefer :-)

--
cinap

Re: [9front] [patch] juke documentation

[Sigrid Solveig Haflínudóttir]

I removed the entire thing.  zuke is merged into 9front.  Going to
write manpages now as well.