Re: Building OSKit-Mach (texinfo format)

[Robert J. Chassell]

   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.

Yes, it is better.  There not much you can do with long URLs.


The new version formats fine for @smallbook, except for the included
`oskit.patch', one line of which is overly long, but not by much.  

For this kind of problem, I would simply insert an @finalout near the
beginning of the Texinfo file so TeX does not produce a dreadful black
box to mark the spot.  Also, I would include a note near the beginning
to explain the problem.  When you change the patch, the problem will
go away.

Also, you might want to remove the @page command right after this
sentence:

    OSKit-Mach also needs a couple
    
patches@footnote{@url{http://mail.gnu.org/pipermail/bug-hurd/2001-July/004654.html}}
    for it to work optimally (again, your line numbers will not
    match):

since the  @page command forces a page break between segments of text
that should be on the same page.


Indeed, for nice hard copy printing, you might write the patch text in
a @smallexample environment, using @group to keep segments together,
and using `@need 1250' for the introductory sentence:



@need 1250
OSKit-Mach also needs a couple 
patches@footnote{@url{http://mail.gnu.org/pipermail/bug-hurd/2001-July/004654.html}}
for it to work optimally (again, your line numbers will not match):

@smallexample
@group
RCS file: /usr/lsrc/flux/CVS/oskit/configure.in,v
retrieving revision 1.149
diff -b -u -r1.149 configure.in
--- configure.in   2001/03/09 19:17:58  1.149
+++ configure.in   2001/08/26 22:05:12
@@ -638,6 +638,12 @@
 [if test $enableval = yes; then enableval=300; fi]
 [OSKIT_DEFS="$OSKIT_DEFS -DLINUX_BOGOMIPS=$enableval"]
 [oskit_options="linux-bogomips=$enableval $oskit_options"])
@end group
@group
+
+flux_ARG_ENABLE(indirect-osenv,
+[  --enable-indirect-osenv internal debugging features and sanity checks],
+[OSKIT_DEFS="$OSKIT_DEFS -DINDIRECT_OSENV=1"]
+[oskit_options="indirect_osenv $oskit_options"])
+

 outfiles="$outfiles Makeconf GNUmakefile
 unsupported/scripts/gcc-driver-script"
 outfiles="$outfiles unsupported/scripts/sym-trace"
@end group
@end smallexample



All in all, the document looks good. (I have not read it, so I don't
know about its content, but that is another matter.  You can focus on
that.)

-- 
    Robert J. Chassell                  bob@rattlesnake.com
    Rattlesnake Enterprises             http://www.rattlesnake.com