groff
[Top][All Lists]
Advanced

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

[Groff] Re: Introduction


From: D. E. Evans
Subject: [Groff] Re: Introduction
Date: Sat, 22 Oct 2005 12:06:56 -0600 (MDT)

    I won't give up on groff.texinfo.  This consequently means that we
    need a groff2texinfo converter (or groff2info to get the more
    important info files) in case the source files are in groff
    format.  Personally, I *really* like the indexing features of
    `info' which are quite powerful.  I'm not aware of a different
    indexing system which is freely available (but I must admit that I
    haven't done an extensive search).

I agree.  However, as a GNU program, GNU users are going to
automatically look at info, not man, (plus, that's the developer
standard).  As much of an irony that it may seem, the manual for
groff would be in groff for the sake of portability to other UNIX
platforms.  I think the manual should be maintained seperately and
simply as a basic reference, refering to the info file for more
complicated or detailed information.

    groff.texinfo contains quite dry material.  It will never become
    a first-read document.  Wouldn't it be more useful to create
    an introductory document from scratch, probably taking the
    introductory stuff from groff.texinfo (which would be consequently
    removed)?

I think that we should build on the work already done, not start
over.  However, I think that revision is needed for the
sake of simplicity and comfort.  The first thing to do would be
to setup an organized structure of what we want in the groff info
manual, then rearrange what we have to fit in that structure,
then add content to complete the structure.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]