[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Solution for ddp/manuals.sgml/faq



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 :)

-- 
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
 Osamu Aoki <debian@aokiconsulting.com>, GnuPG-key: 1024D/D5DE453D
.
 See "User's Guide":     http://www.debian.org/doc/manuals/users-guide/
 See "Debian reference": http://www.debian.org/doc/manuals/reference/
.
 "Debian reference" Project at: http://qref.sf.net
.
 I welcome your constructive criticisms and corrections.


-- 
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org



Reply to: