From keramida@FreeBSD.org  Mon Jun 24 17:43:27 2002
Return-Path: <keramida@FreeBSD.org>
Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5])
	by hub.freebsd.org (Postfix) with ESMTP id 9E05D37B403
	for <bug-followup@FreeBSD.org>; Mon, 24 Jun 2002 17:43:25 -0700 (PDT)
Received: from hades.hell.gr (patr530-a110.otenet.gr [212.205.215.110])
	by mailsrv.otenet.gr (8.12.3/8.12.3) with ESMTP id g5P0hH15029137;
	Tue, 25 Jun 2002 03:43:18 +0300 (EEST)
Received: from hades.hell.gr (hades [127.0.0.1])
	by hades.hell.gr (8.12.4/8.12.4) with ESMTP id g5P0hGIO005492;
	Tue, 25 Jun 2002 03:43:16 +0300 (EEST)
	(envelope-from keramida@FreeBSD.org)
Received: (from charon@localhost)
	by hades.hell.gr (8.12.4/8.12.4/Submit) id g5P0hEdW005491;
	Tue, 25 Jun 2002 03:43:14 +0300 (EEST)
	(envelope-from keramida@FreeBSD.org)
Message-Id: <20020625004313.GA3858@hades.hell.gr>
Date: Tue, 25 Jun 2002 03:43:13 +0300
From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Ross Lippert <ripper@eskimo.com>
Cc: bug-followup@FreeBSD.org
In-Reply-To: <200206150223.TAA24189@eskimo.com>
Subject: Re: Problem Report docs/31653
References: <20020615005312.GA21062@hades.hell.gr> <200206150223.TAA24189@eskimo.com>

>Number:         39812
>Category:       docs
>Synopsis:       Re: Problem Report docs/31653
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jun 24 17:50:01 PDT 2002
>Closed-Date:    Tue Jun 25 15:19:44 PDT 2002
>Last-Modified:  Tue Jun 25 15:19:44 PDT 2002
>Originator:     
>Release:        
>Organization:
>Environment:
>Description:
 --AqsLC8rIMeq19msA
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2002-06-14 19:23 +0000, Ross Lippert wrote:
 > > Since I am not sure what 're-encode' is supposed to mean, ...
 > > What is a 'transcoding application'?
 >
 > Two good and related questions.
 
 Yep, well... since I don't know much about multimedia, and especially
 about video playback & processing, I'll let you decide what the best
 way to phrase this is.  I'm sure a more knowledgeable, on the topic of
 video, doc hacker will fix this if/when the need arises.
 
 > Well, from what I have read on the X site, Xvideo is just a brand
 > new 4.X feature, so it is guarranteed not to work.  I'd rather phrase
 > that last sentence:
 >
 > >       If you find that something
 > >       described here does with XFree86 3.X please let us
 
 			"does work" ...
 
 > >       know.
 
 Cool.
 
 > > :     <para>Before you begin, you should know the model of the video
 > > :       card you have and the chip it uses.  While XFree86 supports a
 > > :       wide variety of video cards, a much smaller number give good
 > > :       playback performance.  To obtain a list of extensions supported
 > >
 > >	"While XFree86 supports a wide variety of video cards,
 > >	 very few of them give good..."
 >
 > Well, I don't want to say 'very few', because that phrasing will
 > automatically become outdated.  Just fewer might be best.
 
 Right.  Well, I don't really mind keeping the original text here.
 
 > > :     <para>Additionally, DVD-decoding will require write permission on
 > > :       the DVD devices.</para>
 > >
 > >	"Note that DVD decoding..."	(or is it "playback" here?)
 >
 > Technically, it is the decryption process.  DeCSS needs to read
 > and write to the acd0 to work its magic.  That's all I know.  I have
 > changed it to decryption.
 
 I see.  How about mentioning it explicitly that it's decryption you're
 talking about.  I don't know much about DVDs, and this sounded
 confusing.  If I can become confused, then any newbie will probably be
 confused too.  This is not what we want though.
 
 > <!--
 >      The FreeBSD Documentation Project
 >
 >      $FreeBSD: doc/en_US.ISO8859-1/books/handbook/sound/chapter.sgml,v 1.=
 31 2002/05/19 10:53:46 asmodai Exp $
 
 Remove everything from $FreeBSD$.  Leave it as I have written it in
 this paragraph, without the `contents' that CVS will update.  If you
 want to remember what the original version was, then add something
 like this to the comments of the file:
 
 	Original revision:	1.31
 
 >     <para>This chapter will describe the necessary steps to configure
 >       your sound card.  The configuration and installation of XFree86
 >       (<xref linkend=3D"x11">) has already taken care of the
 >       hardware issues for your video card, though there may be some
 >       tweaks to apply for better playback.</para>
 >
 >     <para>After reading this chapter, you will know:</para>
 
 Substitute `section' for `chapter' in the above text.
 
 >     <para>For the video sections, it is assumed that XFree86 4.X
 >       (<filename role=3D'package'>x11/XFree86-4</filename>) has been
 >       installed.  XFree86 3.X may work, but it has not been tested
 >       with the what is described in this chapter.  If you find that
 
 	with the what =3D> with what
 
 >       device.  Consult the troubleshooting section for additional
 >       options.</para>
 
 I'd really love it if you could use an id=3D"troubleshooting" thingie in
 that section and just cross-referenced it here...
 
 >       interface.  You may want to install an application such as
 >       <filename role=3D"package">audio/mpg123</filename> to listen to
 >       audio files.</para>
 
 	audio files =3D> MPEG audio files ? maybe ?
 
 >             <row>
 >               <entry><errorname>xxx: gus pcm not attached, out of=20
 
 EOL whitespace.  I'll kill that before committing it, if you don't mind.
 
 >     <para>On FreeBSD-5.X, which uses <filename>devfs</filename> there
 >         is a slightly different set of recommended links:</para>
 >=20
 >       <screen>&prompt.root; ln -sf /dev/acd0c /dev/dvd
 > &prompt.root; ln -sf /dev/acd0c /dev/rdvd</screen>
 
 How about adding a note here that DEVFS links are not persistent, and
 will have to be created every time the system reboots? :-)
 
 >     <para>There are several ways to display video under X11
 >  suffers from a multitude of
 >       possibilities, what will really work is largely hardware
 >       dependent.
 
 ???
 
 >       have a satisfying experience.  You probably should read about
 
 	Minor grammar: You should probably ...
 
 >     <para>Firstly, it is important to know that most of the video
 >       applications which run of FreeBSD were developed as Linux
 >       applications, originating in the past year.  For this reason,
 >       they are both, very experimental and also riddled with
 
 	"both" and "also" is probably a 'repetitition' here ;)
 
 >     <para>By <quote>experimental</quote>, I mean that you can expect
 >       re-encoders, players, and DVD decrypters to have some major
 >       bugs, or interoperability problems with other programs.  Here is
 >       a short list of the sort of things I mean:</para>
 
 	can expect =3D> should expect
 
 or even something less paranoid, like:
 
       <para> By <quote>experimental</quote> I mean that some of these
 	programs might still have some bugs ...
 
 >         <para>The same application on two different machines,
 >           rebuilt on each machine for that machine, plays back the same
 >           file differently</para>
 
 	Add fullstop at end of sentence.
 
 > 	   <username>root</username> to re-encode a DVD title
 > 	   directly.  Since you are likely to be dissatisfied with
 
 	dissatisfied =3D> disappointed ?
 
 >       <screen>&prompt.user; transcode -i input.vob -x vob -V -Z 320x240 \
 > -y opendivx -N 0x55 -o output.avi</screen>
 >=20
 >       <screen>&prompt.user; transcode -i input.vob -x vob -V -Z 320x240 \
 > -y mpeg -N 0x55 -o output.tmp
 > tcmplex -o output.mpg -i output.tmp.m1v -p output.tmp.mpa -m 1</screen>
 
 Is "tcmplex" a command?  If yes, you probably want to add a
 &prompt.user; before the second command too.  Just like you did for
 "transcode" in the first line.
 
 >     <para>The=20
 >       <ulink url=3D"http://www.mplayerhq.hu/DOCS/">
 >       MPlayer documentation</ulink> is very technically informative.
 
 *sigh*
 
 I might start sounding like a really anal retentive old fart, but
 whitespace is my worst enemy.  When you wrap things in <ulink>
 elements, please leave no leading or trailing whitespace within the
 tag pair.  The above should be written as:
 
       <para>The <ulink url=3D"http://www.mplayerhq.hu/DOCS/">MPlayer
 	documentation</ulink> is very technically informative.
 
 Note the lack of whitespace between <ulink> and the text.  Actually,
 there are quite a few spaces where I'd like to add whitespace fixes
 before commiting this, but that can be done right before committing
 it, so don't bother fixing spacing yet.  I am just mentioning things
 that you might want to note for future stuff ;)
 
 There... I think that after this second batch of changes, we're almost
 ready to add this.  Unless someone else feels like reading the chapter
 and commenting, I'd like to get this done before the end of this week.
 
 - Giorgos
 
 
 --AqsLC8rIMeq19msA
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.7 (FreeBSD)
 
 iD8DBQE9F7yh1g+UGjGGA7YRAqzmAJ9mPJz03ai6j97e0fdMaUf6kQ3IlgCePwrr
 4yt01PQ/kCpxTHkNeqmL1rk=
 =/jLC
 -----END PGP SIGNATURE-----
 
 --AqsLC8rIMeq19msA--
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Tue Jun 25 15:18:50 PDT 2002 
State-Changed-Why:  
I managed to foobar this while submitting the followup. 


Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue Jun 25 15:18:50 PDT 2002 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=39812 
>Unformatted:
