9front - general discussion about 9front
 help / color / mirror / Atom feed
* [9front] [patch] juke documentation
@ 2021-04-08 19:25 Romano
  2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
  2021-04-13 11:53 ` Sigrid Solveig Haflínudóttir
  0 siblings, 2 replies; 10+ messages in thread
From: Romano @ 2021-04-08 19:25 UTC (permalink / raw)
  To: 9front

[-- 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

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 19:25 [9front] [patch] juke documentation Romano
@ 2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
  2021-04-08 20:02   ` Romano
  2021-04-10 12:23   ` cinap_lenrek
  2021-04-13 11:53 ` Sigrid Solveig Haflínudóttir
  1 sibling, 2 replies; 10+ messages in thread
From: Sigrid Solveig Haflínudóttir @ 2021-04-08 19:46 UTC (permalink / raw)
  To: 9front

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


^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
@ 2021-04-08 20:02   ` Romano
  2021-04-08 20:11     ` umbraticus
                       ` (2 more replies)
  2021-04-10 12:23   ` cinap_lenrek
  1 sibling, 3 replies; 10+ messages in thread
From: Romano @ 2021-04-08 20:02 UTC (permalink / raw)
  To: 9front

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?

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 20:02   ` Romano
@ 2021-04-08 20:11     ` umbraticus
  2021-04-08 20:16     ` kvik
  2021-04-08 20:28     ` Noam Preil
  2 siblings, 0 replies; 10+ messages in thread
From: umbraticus @ 2021-04-08 20:11 UTC (permalink / raw)
  To: 9front

> 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


^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 20:02   ` Romano
  2021-04-08 20:11     ` umbraticus
@ 2021-04-08 20:16     ` kvik
  2021-04-09 16:25       ` Jacob Moody
  2021-04-08 20:28     ` Noam Preil
  2 siblings, 1 reply; 10+ messages in thread
From: kvik @ 2021-04-08 20:16 UTC (permalink / raw)
  To: 9front

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.


^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 20:02   ` Romano
  2021-04-08 20:11     ` umbraticus
  2021-04-08 20:16     ` kvik
@ 2021-04-08 20:28     ` Noam Preil
  2 siblings, 0 replies; 10+ messages in thread
From: Noam Preil @ 2021-04-08 20:28 UTC (permalink / raw)
  To: Romano

Controversial proposal: remove juke, merge in zuke instead

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 20:16     ` kvik
@ 2021-04-09 16:25       ` Jacob Moody
  2021-04-09 19:47         ` hiro
  0 siblings, 1 reply; 10+ messages in thread
From: Jacob Moody @ 2021-04-09 16:25 UTC (permalink / raw)
  To: 9front

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.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-09 16:25       ` Jacob Moody
@ 2021-04-09 19:47         ` hiro
  0 siblings, 0 replies; 10+ messages in thread
From: hiro @ 2021-04-09 19:47 UTC (permalink / raw)
  To: 9front

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.
>

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
  2021-04-08 20:02   ` Romano
@ 2021-04-10 12:23   ` cinap_lenrek
  1 sibling, 0 replies; 10+ messages in thread
From: cinap_lenrek @ 2021-04-10 12:23 UTC (permalink / raw)
  To: 9front

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

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

--
cinap

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [9front] [patch] juke documentation
  2021-04-08 19:25 [9front] [patch] juke documentation Romano
  2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
@ 2021-04-13 11:53 ` Sigrid Solveig Haflínudóttir
  1 sibling, 0 replies; 10+ messages in thread
From: Sigrid Solveig Haflínudóttir @ 2021-04-13 11:53 UTC (permalink / raw)
  To: 9front

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


^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2021-04-13 12:01 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-08 19:25 [9front] [patch] juke documentation Romano
2021-04-08 19:46 ` Sigrid Solveig Haflínudóttir
2021-04-08 20:02   ` Romano
2021-04-08 20:11     ` umbraticus
2021-04-08 20:16     ` kvik
2021-04-09 16:25       ` Jacob Moody
2021-04-09 19:47         ` hiro
2021-04-08 20:28     ` Noam Preil
2021-04-10 12:23   ` cinap_lenrek
2021-04-13 11:53 ` Sigrid Solveig Haflínudóttir

9front - general discussion about 9front

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://inbox.vuxu.org/9front

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 9front 9front/ http://inbox.vuxu.org/9front \
		9front@9front.org
	public-inbox-index 9front

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://inbox.vuxu.org/vuxu.archive.9front


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git