Online Documentation

Online Documentation

[Steve Holmes]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

t curious.

What format do you all like your online electronic documentation in?  I
mean as choices plain text, HTML, postscript, PDF, info (compiled from
teXinfo), man pages, etc.

I'm asking this partly because I'm fixin' to build some Slackware based
packages for Exim and others and have a choice as to what kind of
documentation to include.  In particular, Exim has I think four
different formats available for their documentation and would be added
separately when installed.  I really don't wanna bloat the package with
four different formats so hence my question.  I'm personally torn
between HTML and info.  The HTML versions are easiest to include where
info, you have to be careful with the global dir file.

Anyway, I just thought I'd ask to get other people's ideas on this
subject.  I have a Slackware compatible package for Exim 4.62 ready to
go as soon as I work out the manual preference.  I could actually leave
it as is with their plain text format and let the end user fetch the
other formats on their own.  I will also have Slack packages for Speech
Dispatcher and Speechd-up available shortly.

- -- 
HolmesGrown Solutions
The best solutions for the best price!
http://ld.net/?holmesgrown
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.7 (GNU/Linux)

iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
9/JWfFv3EDh2TpkAI1coXTw=
=an2F
-----END PGP SIGNATURE-----

Re: Online Documentation

[Charles Hallenbeck]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Steve,

Nice work. Those will be very useful additions to the Slackware distro.

In my opinion, a package should always have a man page, even if it is 
not the main documentation. My own preference for formats is:

1. plain text
2. html
3. everything else.

Chuck

- -- 
The Moon is Waning Gibbous (81% of Full)
Get downloads from http://www.mhcable.com/~chuckh
  and remember, INFORMATION WANTS TO BE FREE!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)

iD8DBQFEkZN7XnuiIOyDVQURAgxYAJ9jvpVgX0cl7C0+NHtG1XrM/JGIJACePKuZ
WBeDyxurVmsaE4IELeMANww=
=sTyb
-----END PGP SIGNATURE-----

Re: Online Documentation

[Alex Snow]

I personally like html docs the best.
On Thu, Jun 15, 2006 at 09:58:41AM 
-0700, Steve Holmes wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
> 
> t curious.
> 
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
> 
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
> 
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
> 
> - -- 
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
> 
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

-- 
lp1 on fire
	-- One of the more obfuscated kernel messages

Re: Online Documentation

[Eunice]

I personally prefer HTML as that is the format I know best and use easiest 
with navigation and all, but keep in mind at this moment I'm still a Windows 
user; looking to build a linux machine.  My second choice would be the text 
format.  Just my two cents; for what it's worth.  (smile)

Eunice Klicker
Dual Stars Softworks
http://www.dualstars.us
----- Original Message ----- 
From: "Steve Holmes" <steve@holmesgrown.com>
To: <speakup@braille.uwo.ca>
Sent: Thursday, June 15, 2006 12:58 PM
Subject: Online Documentation


> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
>
> t curious.
>
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
>
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
>
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
>
> - -- 
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
>
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 

Re: Online Documentation

[Steve Holmes]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

It sounds like HTML has a strong lead:).  I love the ability to navigate
around with hyper links.  That's why I like HTML and info so much.  One
thing I like about info is if you're in an emacs session, you can set
bookmarks down to the row and column of any info document.  Actually,
You could do that with text files as well inside of emacs.  I just wish
we could gain the rich navigation abilities that are now currently
available with some of the Windows screen readers.  Examples: find next
headding element, next table, list, etc.  You can also navigate around
inside tables with a two dimensional view instead of everything being
spewed out in a single column.  I just don't see how this could be
achieved with speakup in the kernel and running elinks or whatever.  I
wonder if this might be easier with Gnopernicus or Orca since they are
more like applications which could scan a browser's internal buffer.

Anyway, I digress; In the case of Exim, the plain text manuals are
included in the base package and I might go ahead and add the HTML docs
as an added bonus.  By default it leaves it in the usr/doc/exim.../doc
directory so one could place them wherever wanted for typical use.  I
tend to move all my HTML docs to my internal web server and have an
index page point to them all.

On Thu, Jun 15, 2006 at 01:21:19PM -0400, Eunice wrote:
> I personally prefer HTML as that is the format I know best and use easiest 
> with navigation and all, but keep in mind at this moment I'm still a Windows 
> user; looking to build a linux machine.  My second choice would be the text 
> format.  Just my two cents; for what it's worth.  (smile)
> 
> Eunice Klicker
> Dual Stars Softworks
> http://www.dualstars.us
> ----- Original Message ----- 
> From: "Steve Holmes" <steve@holmesgrown.com>
> To: <speakup@braille.uwo.ca>
> Sent: Thursday, June 15, 2006 12:58 PM
> Subject: Online Documentation
> 
> 
> > -----BEGIN PGP SIGNED MESSAGE-----
> > Hash: RIPEMD160
> >
> > t curious.
> >
> > What format do you all like your online electronic documentation in?  I
> > mean as choices plain text, HTML, postscript, PDF, info (compiled from
> > teXinfo), man pages, etc.
> >
> > I'm asking this partly because I'm fixin' to build some Slackware based
> > packages for Exim and others and have a choice as to what kind of
> > documentation to include.  In particular, Exim has I think four
> > different formats available for their documentation and would be added
> > separately when installed.  I really don't wanna bloat the package with
> > four different formats so hence my question.  I'm personally torn
> > between HTML and info.  The HTML versions are easiest to include where
> > info, you have to be careful with the global dir file.
> >
> > Anyway, I just thought I'd ask to get other people's ideas on this
> > subject.  I have a Slackware compatible package for Exim 4.62 ready to
> > go as soon as I work out the manual preference.  I could actually leave
> > it as is with their plain text format and let the end user fetch the
> > other formats on their own.  I will also have Slack packages for Speech
> > Dispatcher and Speechd-up available shortly.
> >
> > - -- 
> > HolmesGrown Solutions
> > The best solutions for the best price!
> > http://ld.net/?holmesgrown
> > -----BEGIN PGP SIGNATURE-----
> > Version: GnuPG v1.2.7 (GNU/Linux)
> >
> > iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> > 9/JWfFv3EDh2TpkAI1coXTw=
> > =an2F
> > -----END PGP SIGNATURE-----
> >
> > _______________________________________________
> > Speakup mailing list
> > Speakup@braille.uwo.ca
> > http://speech.braille.uwo.ca/mailman/listinfo/speakup
> > 
> 
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 

- -- 
HolmesGrown Solutions
The best solutions for the best price!
http://ld.net/?holmesgrown
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.7 (GNU/Linux)

iD8DBQFEkbupWSjv55S0LfERAwVqAKDXSbullZBjR1FGV4alKRQyx+S43ACg4Ieh
tpQRQun/7H8M+D9CV3ldSj0=
=4djZ
-----END PGP SIGNATURE-----

Re: Online Documentation

[Gregory Nowak]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

My personal preference from best to worst is text, html, man.

Greg


On Thu, Jun 15, 2006 at 09:58:41AM -0700, Steve Holmes wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
> 
> t curious.
> 
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
> 
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
> 
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
> 
> - -- 
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
> 
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

- -- 
web site: http://www.romuald.net.eu.org
gpg public key: http://www.romuald.net.eu.org/pubkey.asc
skype: gregn1
(authorization required, add me to your contacts list first)

- --
Free domains: http://www.eu.org/ or mail dns-manager@EU.org
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)

iD8DBQFEkb2p7s9z/XlyUyARAp/lAJ0aoTwmvgdIoK5P7GaGmg7vPgMuZACeIDRA
Jmg/k4o0kQVmLCc+/fYxfg8=
=FvFL
-----END PGP SIGNATURE-----

Re: Online Documentation

[Tyler Littlefield]

I like mine in html/text/man I like html better, because usually depending
on who did it, there are links to headings.
Thanks,
~~TheCreator~~
website:
http://tysplace.shaned.net
msn:
compgeek134@hotmail.com
aim:
st8amnd2005
skype:
st8amnd127
moo coder/wizard and administrator

----- Original Message ----- 
From: "Gregory Nowak" <greg@romuald.net.eu.org>
To: "Speakup is a screen review system for Linux." <speakup@braille.uwo.ca>
Sent: Thursday, June 15, 2006 2:06 PM
Subject: Re: Online Documentation


> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> My personal preference from best to worst is text, html, man.
>
> Greg
>
>
> On Thu, Jun 15, 2006 at 09:58:41AM -0700, Steve Holmes wrote:
> > -----BEGIN PGP SIGNED MESSAGE-----
> > Hash: RIPEMD160
> >
> > t curious.
> >
> > What format do you all like your online electronic documentation in?  I
> > mean as choices plain text, HTML, postscript, PDF, info (compiled from
> > teXinfo), man pages, etc.
> >
> > I'm asking this partly because I'm fixin' to build some Slackware based
> > packages for Exim and others and have a choice as to what kind of
> > documentation to include.  In particular, Exim has I think four
> > different formats available for their documentation and would be added
> > separately when installed.  I really don't wanna bloat the package with
> > four different formats so hence my question.  I'm personally torn
> > between HTML and info.  The HTML versions are easiest to include where
> > info, you have to be careful with the global dir file.
> >
> > Anyway, I just thought I'd ask to get other people's ideas on this
> > subject.  I have a Slackware compatible package for Exim 4.62 ready to
> > go as soon as I work out the manual preference.  I could actually leave
> > it as is with their plain text format and let the end user fetch the
> > other formats on their own.  I will also have Slack packages for Speech
> > Dispatcher and Speechd-up available shortly.
> >
> > - -- 
> > HolmesGrown Solutions
> > The best solutions for the best price!
> > http://ld.net/?holmesgrown
> > -----BEGIN PGP SIGNATURE-----
> > Version: GnuPG v1.2.7 (GNU/Linux)
> >
> > iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> > 9/JWfFv3EDh2TpkAI1coXTw=
> > =an2F
> > -----END PGP SIGNATURE-----
> >
> > _______________________________________________
> > Speakup mailing list
> > Speakup@braille.uwo.ca
> > http://speech.braille.uwo.ca/mailman/listinfo/speakup
>
> - -- 
> web site: http://www.romuald.net.eu.org
> gpg public key: http://www.romuald.net.eu.org/pubkey.asc
> skype: gregn1
> (authorization required, add me to your contacts list first)
>
> - --
> Free domains: http://www.eu.org/ or mail dns-manager@EU.org
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.3 (GNU/Linux)
>
> iD8DBQFEkb2p7s9z/XlyUyARAp/lAJ0aoTwmvgdIoK5P7GaGmg7vPgMuZACeIDRA
> Jmg/k4o0kQVmLCc+/fYxfg8=
> =FvFL
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

Re: Online Documentation

[Charles Hallenbeck]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I'm not sure you need to include both text and html, since you can 
easily generate a text file from an html one. 

On the matter of tables, edbrowse does ;a fantastic job with them, 
putting each row of a table on the same line, with vertical bars 
separating the elements. No ambiguity about empty cells.

Chuck

- -- 
The Moon is Waning Gibbous (80% of Full)
Get downloads from http://www.mhcable.com/~chuckh
  and remember, INFORMATION WANTS TO BE FREE!
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)

iD8DBQFEkb/WXnuiIOyDVQURAsDHAJ40SWIyVfW0P5JFobiSohu4LQ2pPwCghHPy
qTP1RkL6ymCykwscmpDJO3U=
=mNGO
-----END PGP SIGNATURE-----

Re: Online Documentation

[Ralph W. Reid]

My preferences in order:

man pages--can be included in existing manual system so they are quick
and easy to look up

html--can include some built-in formatting, and final formatting into
readable text can be performed by my choice of web browser

plain text--quite readable and usable--basically just about equal to
html formatting for me if the formatting is okay (reasonable length
lines, etc.)

info--usable, but I have found that plowing through layers and layers
of info pages can be time consuming if large amounts of info needs to
be plowed through in order to find what I want

postscript--originally created for print formatting, this format would
have to be run through a postscript interpreter to be readable--does
not seem practical unless I need to dump it to a postscript printer,
which would result in printed material which I could not read anyway

PDF--Pretty D**n Fraked!!!  I would have to run it through pdftotext
just to be able to read it at all, and the formatting might or might
not survive the translation.  Please don't use this format if at all
possible!

HTH, and have a _great_ weekend!

On Thu, Jun 15, 2006 at 09:58:41AM -0700, Steve Holmes wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
> 
> t curious.
> 
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
> 
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
> 
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
> 
> - -- 
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
> 
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----

-- 
Ralph.  N6BNO.  Wisdom comes from central processing, not from I/O.
rreid@sunset.net  http://personalweb.sunset.net/~rreid
...passing through The City of Internet at the speed of light!
CIRCLE CIRCUMFERENCE = 2 * _pi * r

Re: Online Documentation

[Dan Murphy]

Actually I think html is my most preferred format since if it's done 
well, one can navigate quickly and efficiently arounbd in the document.
On 
Thu, 15 Jun 2006, Steve Holmes wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
>
> t curious.
>
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
>
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
>
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
>
> - --
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
>
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>

so long as the people do not care to exercise their freedom, those
who wish to tyrannize will do so; for tyrants are active and ardent,
and will devote themselves in the name of any number of gods, religious
and otherwise, to put shackles upon sleeping men.
                 -- Voltarine de Cleyre.

Re: Online Documentation

[Glenn at home]

I would like html, if it was all on one page, but I hate that constant 
linking to new pages while I am into reading something.
So if this is impossible, I would prefer txt over HTML, as it would be all 
in one page/document.

Glenn
----- Original Message ----- 
From: "Dan Murphy" <danmint@verizon.net>
To: "Speakup is a screen review system for Linux." <speakup@braille.uwo.ca>
Sent: Wednesday, June 21, 2006 9:55 AM
Subject: Re: Online Documentation


Actually I think html is my most preferred format since if it's done
well, one can navigate quickly and efficiently arounbd in the document.
On
Thu, 15 Jun 2006, Steve Holmes wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
>
> t curious.
>
> What format do you all like your online electronic documentation in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
>
> I'm asking this partly because I'm fixin' to build some Slackware based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
>
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for Speech
> Dispatcher and Speechd-up available shortly.
>
> - --
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
>
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>

so long as the people do not care to exercise their freedom, those
who wish to tyrannize will do so; for tyrants are active and ardent,
and will devote themselves in the name of any number of gods, religious
and otherwise, to put shackles upon sleeping men.
                 -- Voltarine de Cleyre.

_______________________________________________
Speakup mailing list
Speakup@braille.uwo.ca
http://speech.braille.uwo.ca/mailman/listinfo/speakup 

Re: Online Documentation

[David Poehlman]

daisy?

On Jun 28, 2006, at 7:19 PM, Glenn at home wrote:

I would like html, if it was all on one page, but I hate that constant
linking to new pages while I am into reading something.
So if this is impossible, I would prefer txt over HTML, as it would  
be all
in one page/document.

Glenn
----- Original Message -----
From: "Dan Murphy" <danmint@verizon.net>
To: "Speakup is a screen review system for Linux."  
<speakup@braille.uwo.ca>
Sent: Wednesday, June 21, 2006 9:55 AM
Subject: Re: Online Documentation


Actually I think html is my most preferred format since if it's done
well, one can navigate quickly and efficiently arounbd in the document.
On
Thu, 15 Jun 2006, Steve Holmes wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: RIPEMD160
>
> t curious.
>
> What format do you all like your online electronic documentation  
> in?  I
> mean as choices plain text, HTML, postscript, PDF, info (compiled from
> teXinfo), man pages, etc.
>
> I'm asking this partly because I'm fixin' to build some Slackware  
> based
> packages for Exim and others and have a choice as to what kind of
> documentation to include.  In particular, Exim has I think four
> different formats available for their documentation and would be added
> separately when installed.  I really don't wanna bloat the package  
> with
> four different formats so hence my question.  I'm personally torn
> between HTML and info.  The HTML versions are easiest to include where
> info, you have to be careful with the global dir file.
>
> Anyway, I just thought I'd ask to get other people's ideas on this
> subject.  I have a Slackware compatible package for Exim 4.62 ready to
> go as soon as I work out the manual preference.  I could actually  
> leave
> it as is with their plain text format and let the end user fetch the
> other formats on their own.  I will also have Slack packages for  
> Speech
> Dispatcher and Speechd-up available shortly.
>
> - --
> HolmesGrown Solutions
> The best solutions for the best price!
> http://ld.net/?holmesgrown
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.7 (GNU/Linux)
>
> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> 9/JWfFv3EDh2TpkAI1coXTw=
> =an2F
> -----END PGP SIGNATURE-----
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>

so long as the people do not care to exercise their freedom, those
who wish to tyrannize will do so; for tyrants are active and ardent,
and will devote themselves in the name of any number of gods, religious
and otherwise, to put shackles upon sleeping men.
                  -- Voltarine de Cleyre.

_______________________________________________
Speakup mailing list
Speakup@braille.uwo.ca
http://speech.braille.uwo.ca/mailman/listinfo/speakup


_______________________________________________
Speakup mailing list
Speakup@braille.uwo.ca
http://speech.braille.uwo.ca/mailman/listinfo/speakup

Re: Online Documentation

[Steve Holmes]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

I would love DAISY but that really isn't a viable format for the general
public.  I asked around here to get ideas but I'm mainly thinking about
packages built for Slackware installs and shared with the general Linux
using public.  Plus I don't have a good quick method of rendoring DAISY
books in Linux.  And I can't even get listen-up to work with the stuff I
author with Eclipse writer so my daisy efforts under linux are pretty
much dead for the time being.

On Wed, Jun 28, 2006 at 07:29:43PM -0400, David Poehlman wrote:
> daisy?
> 
> On Jun 28, 2006, at 7:19 PM, Glenn at home wrote:
> 
> I would like html, if it was all on one page, but I hate that constant
> linking to new pages while I am into reading something.
> So if this is impossible, I would prefer txt over HTML, as it would  
> be all
> in one page/document.
> 
> Glenn
> ----- Original Message -----
> From: "Dan Murphy" <danmint@verizon.net>
> To: "Speakup is a screen review system for Linux."  
> <speakup@braille.uwo.ca>
> Sent: Wednesday, June 21, 2006 9:55 AM
> Subject: Re: Online Documentation
> 
> 
> Actually I think html is my most preferred format since if it's done
> well, one can navigate quickly and efficiently arounbd in the document.
> On
> Thu, 15 Jun 2006, Steve Holmes wrote:
> 
> > -----BEGIN PGP SIGNED MESSAGE-----
> > Hash: RIPEMD160
> >
> > t curious.
> >
> > What format do you all like your online electronic documentation  
> > in?  I
> > mean as choices plain text, HTML, postscript, PDF, info (compiled from
> > teXinfo), man pages, etc.
> >
> > I'm asking this partly because I'm fixin' to build some Slackware  
> > based
> > packages for Exim and others and have a choice as to what kind of
> > documentation to include.  In particular, Exim has I think four
> > different formats available for their documentation and would be added
> > separately when installed.  I really don't wanna bloat the package  
> > with
> > four different formats so hence my question.  I'm personally torn
> > between HTML and info.  The HTML versions are easiest to include where
> > info, you have to be careful with the global dir file.
> >
> > Anyway, I just thought I'd ask to get other people's ideas on this
> > subject.  I have a Slackware compatible package for Exim 4.62 ready to
> > go as soon as I work out the manual preference.  I could actually  
> > leave
> > it as is with their plain text format and let the end user fetch the
> > other formats on their own.  I will also have Slack packages for  
> > Speech
> > Dispatcher and Speechd-up available shortly.
> >
> > - --
> > HolmesGrown Solutions
> > The best solutions for the best price!
> > http://ld.net/?holmesgrown
> > -----BEGIN PGP SIGNATURE-----
> > Version: GnuPG v1.2.7 (GNU/Linux)
> >
> > iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
> > 9/JWfFv3EDh2TpkAI1coXTw=
> > =an2F
> > -----END PGP SIGNATURE-----
> >
> > _______________________________________________
> > Speakup mailing list
> > Speakup@braille.uwo.ca
> > http://speech.braille.uwo.ca/mailman/listinfo/speakup
> >
> 
> so long as the people do not care to exercise their freedom, those
> who wish to tyrannize will do so; for tyrants are active and ardent,
> and will devote themselves in the name of any number of gods, religious
> and otherwise, to put shackles upon sleeping men.
>                   -- Voltarine de Cleyre.
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 

- -- 
HolmesGrown Solutions
The best solutions for the best price!
http://holmesgrown.ld.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.7 (GNU/Linux)

iD8DBQFEo2pIWSjv55S0LfERA9wvAJ9PHFnUIvaVlgUSj6T/hFERF3JN6wCcDgMm
ZCCEFMHeRhUSirgBfJGHREI=
=O34l
-----END PGP SIGNATURE-----

Re: Online Documentation

[David Poehlman]

Ah, general public, we hope to fix that.  For daisy writing, you  
might want to look at dbtmaker.  I'm not sure where to get it though.

On Jun 29, 2006, at 1:51 AM, Steve Holmes wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

I would love DAISY but that really isn't a viable format for the general
public.  I asked around here to get ideas but I'm mainly thinking about
packages built for Slackware installs and shared with the general Linux
using public.  Plus I don't have a good quick method of rendoring DAISY
books in Linux.  And I can't even get listen-up to work with the stuff I
author with Eclipse writer so my daisy efforts under linux are pretty
much dead for the time being.

On Wed, Jun 28, 2006 at 07:29:43PM -0400, David Poehlman wrote:
> daisy?
>
> On Jun 28, 2006, at 7:19 PM, Glenn at home wrote:
>
> I would like html, if it was all on one page, but I hate that constant
> linking to new pages while I am into reading something.
> So if this is impossible, I would prefer txt over HTML, as it would
> be all
> in one page/document.
>
> Glenn
> ----- Original Message -----
> From: "Dan Murphy" <danmint@verizon.net>
> To: "Speakup is a screen review system for Linux."
> <speakup@braille.uwo.ca>
> Sent: Wednesday, June 21, 2006 9:55 AM
> Subject: Re: Online Documentation
>
>
> Actually I think html is my most preferred format since if it's done
> well, one can navigate quickly and efficiently arounbd in the  
> document.
> On
> Thu, 15 Jun 2006, Steve Holmes wrote:
>
>> -----BEGIN PGP SIGNED MESSAGE-----
>> Hash: RIPEMD160
>>
>> t curious.
>>
>> What format do you all like your online electronic documentation
>> in?  I
>> mean as choices plain text, HTML, postscript, PDF, info (compiled  
>> from
>> teXinfo), man pages, etc.
>>
>> I'm asking this partly because I'm fixin' to build some Slackware
>> based
>> packages for Exim and others and have a choice as to what kind of
>> documentation to include.  In particular, Exim has I think four
>> different formats available for their documentation and would be  
>> added
>> separately when installed.  I really don't wanna bloat the package
>> with
>> four different formats so hence my question.  I'm personally torn
>> between HTML and info.  The HTML versions are easiest to include  
>> where
>> info, you have to be careful with the global dir file.
>>
>> Anyway, I just thought I'd ask to get other people's ideas on this
>> subject.  I have a Slackware compatible package for Exim 4.62  
>> ready to
>> go as soon as I work out the manual preference.  I could actually
>> leave
>> it as is with their plain text format and let the end user fetch the
>> other formats on their own.  I will also have Slack packages for
>> Speech
>> Dispatcher and Speechd-up available shortly.
>>
>> - --
>> HolmesGrown Solutions
>> The best solutions for the best price!
>> http://ld.net/?holmesgrown
>> -----BEGIN PGP SIGNATURE-----
>> Version: GnuPG v1.2.7 (GNU/Linux)
>>
>> iD8DBQFEkZG9WSjv55S0LfERA/gpAKDdiIxg8BiwOPq3VUJ754y+WMkCIwCg0Aj7
>> 9/JWfFv3EDh2TpkAI1coXTw=
>> =an2F
>> -----END PGP SIGNATURE-----
>>
>> _______________________________________________
>> Speakup mailing list
>> Speakup@braille.uwo.ca
>> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>>
>
> so long as the people do not care to exercise their freedom, those
> who wish to tyrannize will do so; for tyrants are active and ardent,
> and will devote themselves in the name of any number of gods,  
> religious
> and otherwise, to put shackles upon sleeping men.
>                   -- Voltarine de Cleyre.
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>
>
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
>
>

- --
HolmesGrown Solutions
The best solutions for the best price!
http://holmesgrown.ld.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.7 (GNU/Linux)

iD8DBQFEo2pIWSjv55S0LfERA9wvAJ9PHFnUIvaVlgUSj6T/hFERF3JN6wCcDgMm
ZCCEFMHeRhUSirgBfJGHREI=
=O34l
-----END PGP SIGNATURE-----

_______________________________________________
Speakup mailing list
Speakup@braille.uwo.ca
http://speech.braille.uwo.ca/mailman/listinfo/speakup

Re: online documentation

[Tyler Littlefield]

yes, I agree there.
mv *.pdf /dev/NULL
~~TheCreator~~
website:
http://tysplace.shaned.net
msn:
compgeek134@hotmail.com
aim:
st8amnd2005
skype:
st8amnd127
moo coder/wizard and administrator

----- Original Message ----- 
From: "Jude DaShiell" <jdashiel@shellworld.net>
To: <speakup@braille.uwo.ca>
Sent: Friday, June 16, 2006 3:17 AM
Subject: re: online documentation


> info and html are good; text is fine too.  pdf really needs to be carried
> away though.
>
>
>
> _______________________________________________
> Speakup mailing list
> Speakup@braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

re: online documentation

[Jude DaShiell]

info and html are good; text is fine too.  pdf really needs to be carried 
away though.