Re: Solution for ddp/manuals.sgml/faq
On Sunday 21 April 2002 09:01 am, Osamu Aoki wrote:
> Looks like good answer is found.
>
> On Sun, Apr 21, 2002 at 11:11:37AM -0400, Andy Saxena wrote:
> ...
>
> > Even better:
> > What does it mean when a package either Depends, Recommends, Suggests,
> > Conflicts, Replaces, or Provides another package?
>
> Yes, you got it right.
>
> We need to think outside of box. [BOX: this/that <-> this / that]
>
> For words like "Depends" in this context, we should punctuate with ","
> while adding single quotation marks in plain text output and using fixed
> font in PDF/HTML to indicate these are console output words and shall
> not be taken as verbs. Tags like <tt> should do this in SGML.
>
> ---x8 snip-start
> <sect id="depends">What is meant by saying that a package
> <tt>Depends</tt>, <tt>Recommends</tt>, <tt>Suggests</tt>,
> <tt>Conflicts</tt>, <tt>Replaces</tt>, <tt>Provides </tt> another
> package?
> ---x8 snip-end
>
> This is in-line with debiandoc-sgml guideline. Any objection?
>
> Like I said "/" is very colloquial. I agree "," is a way to do.
>
> > I didn't major in English, but I grew up with the language. Besides,
> > English is hardly the perfect language for rules. At some point, it
> > becomes a matter of what sounds right :-}.
>
> Well I know.
>
> Many academic publications have style guide. That is always a good
> reference :)
however you arrange the formatting, you really do need to write 'Depends on,'
and 'Conflicts with,'
otherwise, stylistically, it's just going to look plain ugly and be
grammatically incorrect.
ben
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: