From: lm@mcvoy.com (Larry McVoy)
Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation
Date: Tue, 19 Sep 2017 19:47:33 -0700 [thread overview]
Message-ID: <20170920024733.GG25650@mcvoy.com> (raw)
In-Reply-To: <F33DF7BE-9318-41DF-9595-CAF8412F14C2@bitblocks.com>
Yeah, markdown didn't exist at the time I did webroff and I like, still
like, roff. It says what you want more than how you want to do it.
On Tue, Sep 19, 2017 at 07:34:00PM -0700, Bakul Shah wrote:
> These days I use the markdown format more and more as it is easier and
> more readable than troff/LaTeX and good enough for this sort of documentation.
> There is even LaTeX package for it!
>
> > On Sep 19, 2017, at 7:01 PM, Larry McVoy <lm at mcvoy.com> wrote:
> >
> > So there are links in that that don't work, that user guide is really old,
> > but you should be able to get the idea. If people bitch about the links
> > that don't work I'll see if I can fix them.
> >
> > The skinning is in the Html file.
> >
> >> Here's an example:
> >>
> >> http://www.mcvoy.com/lm/bkdocs/UG/
> >>
> >> is the source, you can look at those files, they are nroff -ms source,
> >> and then look at
> >>
> >> http://www.mcvoy.com/lm/bkdocs/UG/tmp
> >>
> >> and you'll see the web version of the docs. Which is pretty useful.
> >> You've got all the .NH 1 headers in the table of contents down the
> >> left side, and when you click one of them it shows you the .NH 2,
> >> .NH 3 etc headers for just that section.
> >>
> >> And if you go to
> >>
> >> http://www.mcvoy.com/lm/bkdocs/UG/tmp/map.html
> >>
> >> you can get html versions of any .NH 1 section, or the entire thing as one
> >> page.
> >>
> >> It's a ~1700 line perl program (perl 4ish) and it has some ability to skin
> >> the content. Source in http://www.mcvoy.com/lm/bkdocs/UG/webroff
> >
> > --
> > ---
> > Larry McVoy lm at mcvoy.com http://www.mcvoy.com/lm
--
---
Larry McVoy lm at mcvoy.com http://www.mcvoy.com/lm
next prev parent reply other threads:[~2017-09-20 2:47 UTC|newest]
Thread overview: 54+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-09-19 17:01 Jon Steinhart
2017-09-19 17:05 ` Steve Nickolas
2017-09-19 20:31 ` Pete Turnbull
2017-09-19 20:37 ` Warner Losh
2017-09-19 23:35 ` Theodore Ts'o
2017-09-20 0:47 ` Lyndon Nerenberg
2017-09-20 1:02 ` Larry McVoy
2017-09-20 1:09 ` Lyndon Nerenberg
2017-09-20 1:13 ` Larry McVoy
2017-09-20 1:22 ` Larry McVoy
2017-09-20 2:01 ` Larry McVoy
2017-09-20 2:34 ` Bakul Shah
2017-09-20 2:47 ` Larry McVoy [this message]
2017-09-20 6:18 ` Bakul Shah
2017-09-20 4:35 ` Grant Taylor
2017-09-20 5:54 ` Ian Zimmerman
2017-09-24 23:03 ` Ralph Corderoy
2017-09-24 23:35 ` Bakul Shah
2017-09-20 16:49 ` Steffen Nurpmeso
2017-09-20 4:29 ` Grant Taylor
2017-09-20 6:43 ` Peter Jeremy
2017-09-20 8:25 ` Bakul Shah
2017-09-20 9:12 ` Steve Nickolas
2017-09-20 9:34 ` Bakul Shah
2017-09-20 16:48 ` Steffen Nurpmeso
2017-09-20 2:07 ` Theodore Ts'o
2017-09-24 22:58 ` Ralph Corderoy
2017-09-20 4:26 ` Grant Taylor
2017-09-20 16:45 ` Steffen Nurpmeso
2017-09-21 17:33 ` Tony Finch
2017-09-21 18:39 ` Steffen Nurpmeso
2017-09-22 0:02 ` Greg 'groggy' Lehey
2017-09-22 0:30 ` Lyndon Nerenberg
2017-09-22 0:38 ` Larry McVoy
2017-09-22 0:39 ` Lyndon Nerenberg
2017-09-22 0:50 ` Larry McVoy
2017-09-22 1:01 ` Lyndon Nerenberg
2017-09-22 1:08 ` Larry McVoy
2017-09-22 20:09 ` [TUHS] remaking make (Re: " Bakul Shah
2017-09-22 2:25 ` [TUHS] " Warner Losh
2017-09-22 3:26 ` Greg 'groggy' Lehey
2017-09-22 4:09 ` ron minnich
2017-09-22 2:20 ` Warner Losh
2017-09-22 0:36 ` Larry McVoy
2017-09-22 0:40 ` Lyndon Nerenberg
2017-09-22 1:53 ` Michael Parson
2017-09-22 3:25 ` Grant Taylor
2017-09-20 6:20 ` Lars Brinkhoff
2017-09-20 16:39 ` Steffen Nurpmeso
2017-09-24 22:54 ` Ralph Corderoy
2017-09-25 0:16 ` Steve Johnson
2017-09-25 11:30 ` Ralph Corderoy
2017-09-20 18:15 ` Clem Cole
2017-09-20 18:35 ` Jon Steinhart
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20170920024733.GG25650@mcvoy.com \
--to=lm@mcvoy.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).