From: bakul@bitblocks.com (Bakul Shah)
Subject: [TUHS] Another "craft" discussion topic - mindless tool proliferation
Date: Tue, 19 Sep 2017 23:18:31 -0700 [thread overview]
Message-ID: <E1526B80-9F6F-47FC-9116-6C8598EBB5A9@bitblocks.com> (raw)
In-Reply-To: <20170920024733.GG25650@mcvoy.com>
I used *roff for man pages. Used to use man pages as brief
functional specs for new commands. Worked very well. Even
prior to 1985 I usually just kept plain text documents in a
readable format (not unlike "markdown". Though, rather than
# section, ## subsect I used separate ==== and --- lines).
Most of my notes start out in that form and longer ones may
get converted to latex files. But it's nice to have choices!
BTW, Bitkeeper document looks pretty decent.
> On Sep 19, 2017, at 7:47 PM, Larry McVoy <lm at mcvoy.com> wrote:
>
> 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 6:18 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
2017-09-20 6:18 ` Bakul Shah [this message]
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=E1526B80-9F6F-47FC-9116-6C8598EBB5A9@bitblocks.com \
--to=bakul@bitblocks.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).