Merci David.
On Fri, Jul 23, 2010 at 10:14:10PM -0400, David Prévot wrote:
> Neither is /package/.info, and I'm sure many others. Giving an example
> for every one of them just to make sure that people who can't read the
> intro of a chapter would be able to understand any part of it is a
> non-issue in my point of view (anyway, it will make the document larger,
> and people would argue they /can't/ read it because it is too long ;-).
Agreed but a generic short intro at the top of chapter may not be too bad.
Just after <item>rename ...
<item>copy template files such as <file><var>package</var>.install</file>
to something like <file><var>foo</var>.install</file> to match their
corresponding binary package names.
> IMHO this bug should be closed (or tagged wontfix), as it seems like a
> RTFM issue.
I got a bit of the same feeling ... but what we do on the document is
orthogonal problem :-) Let's keep this in positive tone as much as
possible.
> Anyway, please find attach a proposition in order to fix it.
That is constructive.
> It needs to be reviewed because I'm not sure how of the way
> dh_installman(1) works,
It relies on .TH line in the file to decide where it put man page these days.
> but the OP might try and help on this one, and
> of course some approval for the wording: even if it's tiny and I tried
> to copy and paste from other parts of the document, you have to make
> sure that it's proper English...
Oh, French man can always do better in English than Japanese :-) Though,
our common mission is to break English supremacy by sneaking in Frangle
and Japlish. Just joking ...
> + <p>So <package>gentoo</package>'s manual page could be installed by
> creating
> + <file>gentoo.manpages</file> with "<tt>docs/gentoo.1x</tt>".</p>
Yes. Starting sentence with "So ..." is my usual style. This
documentation uses a bit different style. I take your idea.
I am thinking one of the following:
option1:
| This is how <package>gentoo</package>'s <file>gentoo.manpages</file> file
looks
| like to install <file>doc/gentoo.1</file>:
option2:
| To install <file>doc/gentoo.1</file> for the <package>gentoo</package>
| package as manpage, you create a <file>gentoo.manpages</file> file as:
Both are followed by:
| <example>
| docs/gentoo.1
| </example>
Let me think a bit after good night sleep ....
Osamu
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
