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

Re: Installation manual: arch flavors

On Fri, Nov 20, 1998 at 12:48:14AM -0800, Joey Hess wrote:
> Adam Di Carlo wrote:
> >   Should the different flavors of the Installation Manual for the
> >   different released architectures all be in one document, or should
> >   there be different "flavors" of the same document for the different
> >   architectures?
> >From a completly non-technical standpoint, it seems to make good sense to
> keep them in separate flavors of the document. That should confuse a new
> user less.

If I understood it correctly, Adam's method uses conditionals to build
a bunch of installation manuals (one for each architecture) from a
single source file. (Say, if I build the installation manual with the
variable ARCH=i386, I will obtain the info for i386 only, not for the
others). The user won't see any difference, it's just a developers thing.

I think it's a nice idea, and will make the documentation maintainer's
life easier.

Enrique Zanardi					   ezanardi@ull.es

Reply to: