FAQ Maintainers Mailing List
Re: What format?

---------

From: Tom Holub (doosh@best.com)
Date: Tue Aug 08 2000 - 10:30:35 CDT


On Tue, Aug 08, 2000 at 03:14:04PM +0000, David L. Nicol wrote:
> Tom Holub wrote:
> >
> > On Mon, Aug 07, 2000 at 10:37:30PM -0700, Steve Summit wrote:
> > >
> > > (And please don't focus on just the <B>/<I>/<UL> issue, or the
> > > hyperlink-versus-URL issue. Those are just examples; the real
> > > issue here is plain versus specialized text, in general.)
> >
> > I focused on those because they're the only things I use in my FAQ's.
> > I certainly don't think the entire range of HTML and HTML-like code
> > is acceptable for Usenet; perhaps we need "Usenet Markup Language".
> > -Tom
>
> "POD" a.k.a. "Plain Old Documentation" would serve this need;
> it is readable in plain form, and has a bare minumum of tags
> for creating things like bulleted lists and paragraph headings
> and links.
>
> It is what perl documentation is written in.

perl's own POD viewer doesn't even work half the time.

clue [50] perldoc -f localtime
=item localtime EXPR

Converts a time as returned by the time function to a 9-element array
with the time analyzed for the local time zone. Typically used as
follows:

    # 0 1 2 3 4 5 6 7 8
    ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) =
                                                localtime(time);

All array elements are numeric, and come straight out of a struct tm.
In particular this means that C<$mon> has the range C<0..11> and C<$wday>
has the range C<0..6> with sunday as day C<0>. Also, C<$year> is the
number of years since 1900, that is, C<$year> is C<123> in year 2023,
and I<not> simply the last two digits of the year.

(etc...note that it's mangled the formatting, for whatever reason)

Plus, I need to create a HTML version anyway.
 -Tom



[ FAQ Archive | Search FAQ Mail Archive | Authors | Usenet References ]
[ 1993 | 1994 | 1995 | 1996 | 1997 | 1998 | 1999 | 2000
]

---------

faq-admin@faqs.org

© Copyright The Internet FAQ Consortium, 1997-2000
All rights reserved