call for testing: mandoc-1.13.5 release candidate

[Ingo Schwarze <schwarze@usta.de>]

Hi,

now that mandoc-1.14.1 is out of the door, i'm planning to release
the SQLite3-compat version mandoc-1.13.5 soon.  A release candidate
tarball is available for testing:

  http://mdocml.bsd.lv/snapshots/mdocml-1.13.5rc1.tar.gz

Both reports of successes and failures are welcome!


Mandoc 1.13.5 is a backward compatibility maintenance release
containing all the improvements of 1.14.1 except the switch away
from SQLite3 and except catman(8).  It is intended exclusively for
-stable operating systems using mandoc-based apropos(1) who cannot
change the database format just like that - notably FreeBSD-stable.
Everybody else is encouraged to use the 1.14 branch instead because
the 1.14 database format is smaller and faster, the 1.14 makewhatis(8)
has some functionality improvements that could not be ported back,
and because the new code got better testing coverage, so there is
a lower risk of bugs in 1.14.1.


In a nutshell, the basic testing procedure is:

 $ ./configure
 $ make
 $ make regress

For more details, see the INSTALL file in the tarball.
Note that the regression suite does NOT test the database
functionality at all, so please check manually that the database
functionality you need works for you.  One minimal way to do that
looks like this:

 mkdir Test
 mkdir Test/man1
 mkdir Test/man3
 mkdir Test/man5
 mkdir Test/man7
 mkdir Test/man8
 cp *.1 Test/man1
 cp *.3 Test/man3
 cp *.5 Test/man5
 cp *.7 Test/man7
 cp *.8 Test/man8
 ln -s mandoc makewhatis
 ln -s mandoc man
 ./makewhatis Test

Then set "export MANPATH=Test" and play around with "./man -k".
Of course, it is better to try something similar with your real
manual page tree.


Optionally, you can run

 $ echo BUILD_CGI=1 > configure.local
 $ cp cgi.h.example cgi.h

before ./configure, but it is not very important.
I don't expect that anybody will run a 1.13.5 man.cgi(8) server.

Thank you for your support!
  Ingo
--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv