Re: [Groff] Re: New html docs

[Eddie Maddox]

On Sat, 1 Jan 2000, Werner LEMBERG wrote:

> Dear Gaius,
> 
> the logical place and name for a file describing tmac.arkup is
> groff_markup.man placed into the `tmac' subdirectory, and your html.ms

I'm not going to comment on Werner's comment here. I just want to let you
know what I hope to do soon, while I learn some more about Groff HTML,
make, CVS, whatever.

O'Reilly has a book, "Information Architecture for the World Wide Web",
1998, Louis Rosenfeld & Peter Morville. It uses library science and
similar disciplines to develop ways to organize Web site information for
users to most easily navigate it.

Certainly much material is available on Web site design, I have other
works myself, but I want to start with the principles in this one work and
see if I can present a "User Friendly Navigation Interface" to all Groff
documentation. This includes Richard Steven's materials and others that
have been pointed out to us on this mailing list.

When I begin to do this (a week or two?) I will need to know where all the
Groff docs are that are currently in the Groff releases. Many of the
directories/file names do not make it obvious to me which are for docs and
which for code. Some I know, but some are stange. Like tmac. (Docs in
tmac?  They aren't all in the doc directory?) Not obvious tmac has docs.

So, please, can someone just think about writing up something the next few
days on where every Groff doc file is in the Groff releases, or how I can
tell for myself? 

Thank you.

> Another related problem: I can imagine that a lot of people start to
> write man pages with HTML output in mind also.  Nevertheless, it
> should be still possible to display such pages correctly with a plain
> text man pager.  As a consequence, such man pages should contain at

From: Eddie Maddox <address@hidden>
Subject: Re: [Groff] Little problem yet.

> groff -t -Tlatin1 -mandoc ~/groff/groff-1.15/grohtml/design.ms | less
                            ~/groff/install/man/man1/grog.1

> groff -t -Thtml -mandoc ~/groff/groff-1.15/grohtml/design.ms | less
                          ~/groff/install/man/man1/grog.1

I have't run the last one through lynx, Netscape or Amaya yet, but it
looks pretty good for raw HTML viewing it with less (just for a quick
check on getting the right Groff arguments).

------------------
Eddie Maddox
address@hidden