The Speakup User's Guide, official release

Janina Sajka janina at rednote.net
Thu Mar 31 18:41:52 EST 2005


Sure, Christy. I've got plenty to do, so if you're able to help, that
works for me.

My HOWTO is nothing fancy either. My thought was to simply use the same
approach as in the HOWTO:

http://www.linux-speakup.org/ftp/disks/fedora/HOWTO_INSTALL.html

You'll notice there's a fairly extensive header. That helps get the doc
properly indexed by the Googles of the world.

I use basic tables in one place--where I list the supported Speakup
synths. I would expect this basic table structure would be very
important in the user HOWTO.

Beyond that, there're just pound hrefs to various sections from the
Table of Contents, and then a returning hyperlink.

Would you want to take the first cut?

Christy Schulte writes:
> If I can help at all with the html conversion process, let me know. I don't
> know any of the fancy html stuff, but I can do a basic document with a table
> of contents, headings, and the like that is simple and easily accessible.
> Christy
> 
> 
> 
> -----Original Message-----
> From: speakup-bounces at braille.uwo.ca
> [mailto:speakup-bounces at braille.uwo.ca]On Behalf Of Janina Sajka
> Sent: Thursday, March 31, 2005 12:00 PM
> To: Speakup is a screen review system for Linux.
> Subject: Re: The Speakup User's Guide, official release
> 
> 
> No, the real thanks here need to go to you for making this user level
> HOWTO. We've desparately needed it for many years. It's a great
> document, and I expect a lot of people are going to get serious benefit
> from it for many years to come. Thanks to you for making such a great
> doc. And thanks for getting it so right on the first pass. I happen to
> know how hard that can be! <grin>
> 
> Gene Collins writes:
> > Thanks Janina.  I have just updated the text file on the site to be
> > licensed under the gnu/fdl.
> >
> > I went and read the license text from the sfs site, and it looks like
> > what I intend.
> >
> > Thanks for pointing me at this.
> >
> > Gene
> >
> > >OK, Gene. I'll undertake an html edition of your HOWTO. I'll send it to
> > >you first when I've finished. I agree about the value of keeping both a
> > >plain text and html edition.
> > >
> > >I think the main diff between GPL and GFDL is the language involved.
> > >After all, documentation is not code. So, the GPL's authorization to
> > >copy and improve code is meaningless with documentation. The GFDL
> > >specifies about the freedom to distribute, modify, etc., and under what
> > >conditions--in other words keeping the same principles in play, but for
> > >the text, not for the code that isn't present anyway.
> > >
> > >Thus, copyright being a legal thing, it has some legal teeth, where GPL
> > >probably doesn't. But, I am no lawyer as you well know.
> > >
> > >Gene Collins writes:
> > >> Hi Janina.  The version number is a good idea.
> > >>
> > >> If you'd like to make an html file, I'd apreciate that.  The Table of
> > >> Contents is a good idea, as well as links to the urls mentioned in the
> > >> document.
> > >>
> > >> When you have the html file ready, let me know.  I think we'll keep
> both
> > >> the html version and the plain text version on the site.
> > >>
> > >> I haven't checked out the documentation license yet.  Can you brieffly
> > >> summarize the differences from the GPL?  Thanks.
> > >
> > >_______________________________________________
> > >Speakup mailing list
> > >Speakup at braille.uwo.ca
> > >http://speech.braille.uwo.ca/mailman/listinfo/speakup
> >
> > _______________________________________________
> > Speakup mailing list
> > Speakup at braille.uwo.ca
> > http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> --
> 
> Janina Sajka				Phone: +1.202.494.7040
> Partner, Capital Accessibility LLC	http://www.CapitalAccessibility.Com
> 
> Chair, Accessibility Workgroup		Free Standards Group (FSG)
> janina at freestandards.org		http://a11y.org
> 
> If Linux can't solve your computing problem, you need a different problem.
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup at braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup
> 
> 
> --
> No virus found in this incoming message.
> Checked by AVG Anti-Virus.
> Version: 7.0.308 / Virus Database: 266.8.5 - Release Date: 3/29/2005
> 
> 
> --
> No virus found in this incoming message.
> Checked by AVG Anti-Virus.
> Version: 7.0.308 / Virus Database: 266.8.5 - Release Date: 3/29/2005
> 
> --
> No virus found in this outgoing message.
> Checked by AVG Anti-Virus.
> Version: 7.0.308 / Virus Database: 266.8.5 - Release Date: 3/29/2005
> 
> 
> _______________________________________________
> Speakup mailing list
> Speakup at braille.uwo.ca
> http://speech.braille.uwo.ca/mailman/listinfo/speakup

-- 

Janina Sajka				Phone: +1.202.494.7040
Partner, Capital Accessibility LLC	http://www.CapitalAccessibility.Com

Chair, Accessibility Workgroup		Free Standards Group (FSG)
janina at freestandards.org		http://a11y.org

If Linux can't solve your computing problem, you need a different problem.





More information about the Speakup mailing list