Re: Automatically updated Table of Contents with Nroff

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

 




--On Thursday, March 24, 2011 02:14 +0100 Stefan Santesson
<stefan@xxxxxxxxxxx> wrote:

> I can't escape the feeling that this discussion of using
> markup language editing to produce RFCs, is a bit upside down.
> 
> I'm much more concerned with draft writers having to deal with
> markup syntax than I am about drafters trying to put a page
> break in a sensible location, or format their text in a
> readable fashion.
>...

Stefan,

Parts of this are just a matter of taste.    While I have
learned to prefer generic markup approaches over formatting
markup, I certainly started with the latter (if you know nroff's
history, I used runoff on CTSS).   And I've done a good many
Internet Drafts (including several that evolved into RFCs) in
emacs and its clones: fancy formatting, page headers and
footers, etc., have never been requirements for I-Ds.   I used
TeX and LaTeX for a while, still prefer them for some
applications, and miss a few of their features for some
Internet-Drafts and RFCs.

I actually tried to be neutral about the issue in my note, but
let me be more explicit.  If nroff works for you, please use it.
My first priority in these discussions is to push back on any
effort to require a particular formatting tool or set of macros
for I-Ds, regardless of what that tool might be.

> The latter is not a problem that consumes a lot of energy,
> neither do I believe that drafters concern with readability is
> a matter that causes the RFC production center a lot of
> headache. So why is this a matter of concern?
> 
> I honestly think people waste a lot more time trying to figure
> out how to properly form correct markup syntax, than they do
> with format tweaking.

I think it depends on the person and sometimes on the document.
As I said, I've gradually learned to prefer generic markup, but
I'm definitely not inclined to impose that on anyone else.
What I'm opposed to, and what prompted my note, was purely what
I consider a misguided effort to turn the xml2rfc model from
generic markup into a formatting language.  My own intuition,
based on some experience with more traditional publications but
without having discussed this with either the RFC Production
Center or the RSE (the latter because we still don't have one),
is that we are actually better off having roughly-formatted and
roughly-edited documents passed off to the RFC Editor staff and
letting them do final technical and copy editing and page
layout.  From my point of view, that is called "letting the
professionals do their jobs".

I agree with John Levine's comment that whatever you know
already and are used to using is better.  What I think of his
"dead end" option is irrelevant.  You should use what works for
you.  I will probably admire your nroff tools but am unlikely to
use them.   I will use what works for me and won't try to
convince you that you should switch.  And we both should oppose
anything that forces everyone into a single set of tools for
preparing I-Ds.

> In my ideal world, where XML would work at its best, drafters
> would concentrate on writing text in a fashion that could be
> captured into XML (or any functional markup language), making
> XML the output of the editing process rather than the input.

Well, then, we agree almost completely.  In my ideal world,
people doing drafts would do as little markup as possible.  I
think there are still advantages to identifying some things,
especially comments and placeholders) as what they are.  YMMD on
that subject, or you may have a different list.  I don't think
xml2rfc is ideally designed from that standpoint, for some
reasons that are inherited from XML and some that are exclusive
to it.  I don't have the time or energy to redesign it and I'm
not sure I could do much better (although I'd probably make a
different set of what are, IMO, mistakes).

However, if carried to anything near its limit, that gets one
back to the "edit in emacs (or another plain-text editor of your
choice) and then hand things off to the RFC Editor staff" model.
If I were posting a few I-Ds a year --too few for me to remember
how to use xml2rfc efficiently-- and were not doing many of them
in collaboration with others, I'd probably go back to it.
 
> That way it would not hurt the drafters if the XML syntax was
> extended to capture both content and format, making it a
> complete input to the rendering process.
> 
> Given the rather primitive structure of RFCs, writing such
> editor seem not to be such a grim task. I'm even tempted to
> provide one in the next major version of NroffEdit, where you
> could choose nroff and/or XML as markup, but never bother with
> it when writing your draft.
> 
> If the XML syntax was expanded to capture formatting then that
> could indeed render nroff obsolete . Right now I would have to
> keep relying on nroff to ensure that the document is rendered
> as written.

Again, if the XML2RFC syntax were "expanded" to specify
formatting, it would seriously break the generic markup model
that inspired XML and its main predecessor.  That would not,
IMO, be an improvement.  

   john

_______________________________________________
Ietf mailing list
Ietf@xxxxxxxx
https://www.ietf.org/mailman/listinfo/ietf


[Index of Archives]     [IETF Annoucements]     [IETF]     [IP Storage]     [Yosemite News]     [Linux SCTP]     [Linux Newbies]     [Fedora Users]