Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* Dan Jacobson <[EMAIL PROTECTED]> [2006-01-18 01:29]:
> Subject: Re: man jack promises MP3's but get OGGs
^
By the way, given that you're the person reporting most spelling
errors to Debian, it should be "MP3s" and not "MP3's". ;-)
-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* Dan Jacobson <[EMAIL PROTECTED]> [2006-01-18 01:29]:
>-e, --encoders int
>   encode  how many files in parallel. If you have a SMP machine or
>   simply want to stress your system, you can have Jack encode sev-
>   eral files at once.
> 
> Say what the default is too here (1). Answer seen only with jack --longhelp.


Mention the default of the --encoders option in the man page.

--- jack/jack.man~  2006-01-27 15:20:25.0 +
+++ jack/jack.man   2006-01-27 15:21:19.0 +
@@ -160,7 +160,7 @@
 .B \-e, \-\-encoders int
 encode how many files in parallel. If you have a SMP machine or
 simply want to stress your system, you can have Jack encode
-several files at once.
+several files at once (default 1).
 .TP
 .B \-x, \-\-exec
 run predefined command when finished.

-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* Martin Michlmayr <[EMAIL PROTECTED]> [2006-01-27 15:07]:
> @@ -445,7 +445,7 @@
>  .RE
>  .PP
>  when successful the files are now renamed to something more readable and 
> -have been ID3 tagged accordingly. jack.freedb contains the queried freedb
> +have been tagged accordingly. jack.freedb contains the queried freedb
>  entry, the original file has been backed up to jack.freedb.bak.
>  .PP
>  All in one: query, rip, encode, cleanup:

Actually, my version already says:

 If the query is successful the files will be renamed to something more
 readable and will be tagged accordingly using ID3 or Vorbis tags.  The
 file jack.freedb will contain the queried FreeDB entry, and the
 original file will be backed up as jack.freedb.bak.

But the first hunk of the patch still applies.  Anyway, here's an
improved version of the patch:


--- jack.man~   2006-01-27 15:12:00.0 +
+++ jack.man2006-01-27 15:19:09.0 +
@@ -23,8 +23,8 @@
 .SH DESCRIPTION
 .B Jack 
 transforms your audio-CDs to FLAC, MP3 or Ogg Vorbis files. It uses several
-helper programs in order to achieve things like ripping, encoding and
-ID3-tagging.  Ripping is either done via
+helper programs in order to achieve functions such as ripping, encoding and,
+tagging files with meta information.  Ripping is either done via
 .B cdparanoia
 (in which case the ripping status is displayed by Jack as well) or
 .B cdda2wav.
@@ -33,11 +33,10 @@
 and
 .B xing.
 Any time during operation (and even when everything is finished and
-the original CD lost) you can let Jack look up the track names at 
+the original CD lost) you can let Jack look up the track names at
 .B freedb.org
-and rename the tracks accordingly. ID3-tagging of MP3s (or insertion
-of equivalent comment fields in Ogg Vorbis files) is performed
-as well. 
+and rename the tracks accordingly. Tagging of audio files with meta
+information about artist, track title, etc. is performed as well.
 .PP
 If no freedb-lookup has been performed, Jack drops all files in a
 directory
@@ -48,7 +47,7 @@
 This directory is renamed by Jack when the appropriate information is known.
 .PP
 Most options like ripper, encoder, preferred FreeDB-Server, directory
-and MP3-filename format, etc. can be user defined by changing the
+and sound file format, etc. can be user defined by changing the
 defaults in 
 .B /etc/jackrc
 or by saving them to
@@ -196,15 +195,15 @@
 the TOC is read from the CD itself.
 .TP
 .B \-g, \-\-guess-toc list
-make up a TOC from the MP3 file given in mp3_files. Format is 
-.B track_01.mp3 ... track_nn.mp3 ;
+make up a TOC from the list of sound file given. The format is
+.B track_01.ogg ... track_nn.ogg ;
 Note that the trailing "
 .B ;
 " is only necessary if you want to
 append more options to your command line.
-You can use it to do a FreeDB query based on
-MP3s alone - no need for the CD. Very useful if you have no idea
-which CD the MP3s are from. The MP3s must be given in the same
+You can use it to do a FreeDB query based on your sound files
+alone - no need for the CD. Very useful if you have no idea
+which CD the songs are from. The songs must be given in the same
 order as they were on their CD. The generated TOC file is
 similar, but not identical to the TOC of the CD - do not submit
 these!
@@ -213,7 +212,8 @@
 set ID3 genre. Use 'help' to get a list of all known genres. (You can also 
specify the ID3v1 genre as an int)
 .TP
 .B \-Y, \-\-id3-year int
-set ID3 year.
+set the year of the album (the term ID3 comes from MP3 but this option also
+works with other audio formats, such as OGG Vorbis and FLAC)
 .TP
 .B \-h, \-\-help
 Show summary of options.
@@ -298,7 +298,7 @@
 is used, 
 then the file is queried from your FreeDB server). If you have
 changed its contents (e.g. because the CD was unknown to FreeDB)
-and want to rename and tag your MP3s accordingly, use this option.
+and want to rename and tag your audio files accordingly, use this option.
 Give all other needed options too, like
 .B \-t
 , 
@@ -379,7 +379,7 @@
 undo file renaming and exit. If you don't like how Jack renamed
 your files, use this option to restore the previous state.
 Several levels of undo are possible. Note
-that ID3 tags are not restored.
+that meta information tags are not restored.
 .TP
 .B \-\-unusable-chars list
 characters which can't be used in filenames (default "/").

-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* David Whitmarsh <[EMAIL PROTECTED]> [2006-01-27 07:02]:
> >README and man page say:
> >* Insert a CD, fire up jack:
> >  $ jack
> >  Now watch it work. It's fun for a while. After having  
> >finished, you have
> >  the follwing files on your HD: track_01.mp3, track_02.mp3, ...,
> >Not true! One ends up with OGG files by default!
> >   --encoder-name, -E string
> >  use which encoder (default "oggenc")
> You're right, the man page should say that you'll get ogg files.


By default OGGs are generated now rather than MP3s, update man page
accordingly.  Patch by David Whitmarsh <[EMAIL PROTECTED]>


diff -u jack-3.1.1/jack.man jack-3.1.1-348547/jack.man
--- jack-3.1.1.old/jack.man 2004-12-12 04:54:35.0 +
+++ jack-3.1.1/jack.man 2006-01-27 12:38:48.0 +
@@ -424,8 +424,8 @@
 .RE
 .PP
 Now watch it work. It's fun for a while. After having finished, you have
-the following files on your HD: track_01.mp3, track_02.mp3, ...,
-track_nn.mp3 plus jack.toc, jack.freedb, jack.progress. The last three are
+the following files on your HD: track_01.ogg, track_02.ogg, ...,
+track_nn.ogg plus jack.toc, jack.freedb, jack.progress. The last three are
 used to store the state jack is in so it can resume work when interrupted.
 .PP
 Jack will create a directory called jack- for you, there it
@@ -445,7 +445,7 @@
 .RE
 .PP
 when successful the files are now renamed to something more readable and 
-have been ID3 tagged accordingly. jack.freedb contains the queried freedb
+have been tagged accordingly. jack.freedb contains the queried freedb
 entry, the original file has been backed up to jack.freedb.bak.
 .PP
 All in one: query, rip, encode, cleanup:


-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* David Whitmarsh <[EMAIL PROTECTED]> [2006-01-27 07:02]:
> I am unaware of any way to make jack tell you which encoders it
> thinks it can find the binaries for.

It cannot.  Note sure if that's useful since it'll complain if you
specifiy an encoder that isn't available.

> The attached patch changes the  man page to reflect the fact that
> jack produces oggs by default.

Thanks.
-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread Martin Michlmayr
* Dan Jacobson <[EMAIL PROTECTED]> [2006-01-18 01:29]:
>   the follwing files on your HD: track_01.mp3, track_02.mp3, ...,
> Not true! One ends up with OGG files by default!
>--encoder-name, -E string
>   use which encoder (default "oggenc")
> See? And say how to find out what the other choices are.

Yes, you're right...

>-e, --encoders int
>   encode  how many files in parallel. If you have a SMP machine or
>   simply want to stress your system, you can have Jack encode sev-
>   eral files at once.
> Say what the default is too here (1). Answer seen only with jack --longhelp.

... but please report different bugs in different bug reports.

-- 
Martin Michlmayr
http://www.cyrius.com/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Bug#348547: man jack promises MP3's but get OGGs

2006-01-27 Thread David Whitmarsh


On Jan 17, 2006, at 11:29 AM, Dan Jacobson wrote:


README and man page say:
* Insert a CD, fire up jack:
  $ jack
  Now watch it work. It's fun for a while. After having  
finished, you have

  the follwing files on your HD: track_01.mp3, track_02.mp3, ...,
Not true! One ends up with OGG files by default!

   --encoder-name, -E string
  use which encoder (default "oggenc")

You're right, the man page should say that you'll get ogg files. For  
a list of the encoders supported, that's also in the man page. It  
says in the first paragraph:
	Jack works  with  several encoders, namely oggenc, flac, lame, gogo,  
bladeenc, l3enc, 		mp3enc and xing.
As far as I know, the only ones on that list included in debian are  
flac and oggenc.
I am unaware of any way to make jack tell you which encoders it  
thinks it can find the binaries for. The attached patch changes the  
man page to reflect the fact that jack produces oggs by default.


jack.348547.patch
Description: Binary data





smime.p7s
Description: S/MIME cryptographic signature


Bug#348547: man jack promises MP3's but get OGGs

2006-01-17 Thread Dan Jacobson
Package: jack
Version: 3.1.1-13
Severity: wishlist
File: /usr/share/doc/jack/README

README and man page say:
* Insert a CD, fire up jack:
  $ jack
  Now watch it work. It's fun for a while. After having finished, you have
  the follwing files on your HD: track_01.mp3, track_02.mp3, ...,
Not true! One ends up with OGG files by default!

   --encoder-name, -E string
  use which encoder (default "oggenc")

See? And say how to find out what the other choices are.

   -e, --encoders int
  encode  how many files in parallel. If you have a SMP machine or
  simply want to stress your system, you can have Jack encode sev-
  eral files at once.

Say what the default is too here (1). Answer seen only with jack --longhelp.


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]