[CF List] Documentation

[Mark Wedel]

Jacek Konieczny wrote:
>
     
     
     >
     
      I have just compiled HTML and PDF crossfire documentation. I had to
     
     >
     
      heavily modify PostScript documentation build process to get hi-quality
     
     >
     
      PDF docs (in oposition to PDF made from PostScript or PDF with raster
     
     >
     
      fonts). I sill don't like the result, though. It seems docs sources are
     
     >
     
      not quite up to date. In particular:
     
     >
     
     
     >
     
              - Initial equipment handbook section doesn't seem to work at all
     
     >
     
                brobaly because of change in player selection procedure
     
     
 Almost certainly that is the case.  probably most all documentation in the
server dealing with race/class is wrong, because it was written before the
race/class split.

 On the bright side, the in game documentation for races and classes is better
than it ever has been, so its not quite as critical that this information is up
to date.

 Almost certainly what would be needed is the addition of some text in the
handbook, and some code to collect the class information (fortunately, the class
have their own types, so extracting the right arch's wouldn't be hard).

 Other than specific filtering, I don't know of a way to prevent the bogus
entries (no_class_face_change) from showing up in the lists.

 I will noote the extended documentation also is no longer really correct.  With
partial resistance code, many races have some minor bonus to some resistances,
and the meaning of vulnerable, protected, and immune have different meanings.

>
     
     
     >
     
              - In the handbook some mess is shown as books (several monsters
     
     >
     
                and empty squares).
     
     >
     
     
     >
     
      These don't work for HTML doc neither.
     
     >
     
      How can I fix this?
     
     
 This is in the poorly named makeps program.  I've checked in this change:
Remove the substitution of _ to - in the image names.  This breaks
image links, and I'm not really sure why it is ever needed.
MSW 2001-04-22.