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

Re: proofreading the installation-guide

On Sun, Jul 26, 2015 at 02:37:45PM +0100, Justin B Rye wrote:
> Hendrik Boom wrote:
> > Justin B Rye wrote:
> >>  * &entity questions - when am I meant to say "Debian" and when is it
> >> 	"&debian;"?  This like many of these entities seems to have no
> >> 	obvious function other than to make the source harder to
> >> 	interpret...
> >>  * The &d-i; entity expands to "debian-installer" in bold verbatim
> >> 	lowercase.  If that is in effect the brandname of the software
> >> 	project then presumably we shouldn't be talking about "the
> >> 	&d-i;" - that ought to be "the Debian installer".
> > 
> > Presumably both of these parametrisations are for the convenience of 
> > Debian derivatives and forks.  By making these macros, it's easier for 
> > the, and it'll be easier for us to merge downstream patches.
> An interesting idea, but one that seems unlikely to work, especially
> given the way it's used in the text.  For instance, there's a page
> "welcome/what-is-debian-linux.xml", which is full of sentences like
> "&debian; was the first Linux distribution to include a package
> management system".

It makes me wonder whether this was originally the intention, but has 
become lost as generations of editors failed to follow up on it.

-- hendrik

Reply to: