lkml.org 
[lkml]   [2007]   [Aug]   [9]   [last100]   RSS Feed
Views: [more markup]  [less markup]  [headers]  [forward] 
 
Messages in this thread
/
DateThu, 9 Aug 2007 12:58:10 -0700
From"Brennan Ashton" <>
SubjectRe: Documentation files in html format?
On 8/9/07, Stefan Richter <stefanr@s5r6.in-berlin.de> wrote:
> Stephen Hemminger wrote:
> > Advantages of html:
> >   * basic formatting like lists, italics, etc
>
> Plaintext has lists too.  See for example
> <20070809113122.3aa508e4@oldman.hamilton.local>.  ;-)
>
> It's also possible to approximate bold face, italics, and underlines in
> plaintext.
>
> >   * easier to integrate into other places and retain formatting
>
> Out-of-tree places?
>
> >   * ability to link documents and to external sources easier
>
> In which way are URIs and other references in HTML easier than in plaintext?
>
> > Downsides:
> >   * can become too formatted and unclear
> >   * accessibility and translation issues?
> >   * even more style issues
>
> Indeed.
> --
> Stefan Richter
> -=====-=-=== =--- -=--=
> http://arcgraph.de/sr/
> -
> To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
> Please read the FAQ at  http://www.tux.org/lkml/
>
I am with you on this one, i am less than convinced that HTML is
better, IMHO it is a wrong direction.  Plain Text documentation is one
of the things i love about linux, it has worked for so many years why
change now. As Stefan explained there are simple ways to get around
all of the points that you gave.

-- 
Brennan Ashton
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

\
 
 \ /
  Last update: 2007-08-09 20:01    [from the cache]
©2003-2008