Re: Building OSKit-Mach (texinfo format)

[Kevin Kreamer]

Robert, thank you for your help.  Jeff, here's that doc I was
telling you about.

On Sat, Sep 22, 2001 at 01:14:35PM +0000, Robert J. Chassell said:
> The document formats without reported error, except for one overfull
> and one underfull hbox in the TeX dvi output.

Ok, I've changed the overfull paragraph around a bit, and now it's 
a underfull paragraph, which is better I suppose.  Both of those 
are caused by longish URL's in the paragraphs, I'm not sure what else can 
be done.

> It is convenient to include the following summary of shell commands at
> the beginning of your Texinfo document.  This set of commands makes it
> easy for reviewers and users to create the different outputs.  You can
> run them in shell in Emacs, or copy them to an Xterm in X Windows.

I've added these to the newest revision.

> Also, I find that @smallbook produces the best size printed output,
> even on US letter sized paper or on A4 paper.  My eyes have an easier
> time tracking `conventional book' length of lines in @smallbook and my
> red editor's pen prefers the wider margins.  (If your examples are
> wide, @smallbook requires that you replace @example with
> @smallexample.)

I realised that I hadn't actaully run it through TeX, because my main 
focus was the .info file.  Consequently, there was a few goofs that 
only showed up the TeX formats (like the table of contents being in 
the wrong place).  I think it's best, then, to get this updated copy 
out to everyone instead of worrying about @smallbook.  I may 
move it there in the future, and I'll keep this point in mind whenever 
I write more docs, so thank you for pointing it out.

Kevin
-- 
Kevin Kreamer
FsckIt on openprojects.net

oskit-mach.texi
Description: TeXInfo document

oskit-mach.patch
Description: Text document

oskit.patch
Description: Text document