Hi Ingo, > Oh well, but please make sure *first* you yourself understand > thoroughly what you are talking about. Right now, that doesn't > seem to be the case, yet. Misleading upstream projects into > *about* the right direction but subtly mixing the education > with bad advice is *not* helping. > > Let me be clear about that: Before you know both the man(7) and > the mdoc(7) language very well, have a very good understanding > of their strengthes, weaknesses and differences, and have quite > some experience writing mdoc(7) code of good quality, you should > not attempt to educate upstream, or it will end up in confusion > and anger.
point taken. Before trying to touch ports and talk to upstream, I will try to find me something small in our tree. > > Or is there something in base still not converted to mdoc? > > Why not search for such files yourself? > Watch out for lines starting with .TH. scan_ffs.8 This is actually rewritten in mdoc(7) already, just the ".TH scan_ffs 8" line was somehow left in the top comment block; so here goes Index: scan_ffs.8 =================================================================== RCS file: /cvs/src/sbin/scan_ffs/scan_ffs.8,v retrieving revision 1.16 diff -u -p -u -p -r1.16 scan_ffs.8 --- scan_ffs.8 23 Mar 2008 23:28:46 -0000 1.16 +++ scan_ffs.8 4 Jul 2013 09:54:27 -0000 @@ -23,7 +23,6 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" .TH scan_ffs 8 .Dd $Mdocdate: March 23 2008 $ .Dt SCAN_FFS 8 .Os usr/src/usr.bin/tic/tic.1 usr/src/usr.bin/tic/infotocap.1 This seems to be a thing from base not yet converted to mdoc(7), and an easy enough manpage to start with. Or is this part of curses, maintained upstream, not to be touched? > But make sure you exclude files maintained upstream. > Converting stuff in base would be counter-productive > if that causes headaches for the next update. > > In particular, the following should not be converted: Yes, these I found (and wondered whether they would be a good candidate); so I am not touching these. > - Perl stuff > - binutils Ah, there is /usr/src/usr.bin/strings/strings.1 /usr/src/usr.bin/strings/strings.c and there is also /usr/src/gnu/usr.bin/binutils/binutils/strings.c /usr/src/gnu/usr.bin/binutils/binutils/doc/strings.1 The former has an mdoc(7) manpage, but this is not what we install: we use the strings(1) from GNU binutils, right? (This seems to be the case with many other utils.) > - any gcc versions > - curses > - GNU cvs > - bind and nsd > - lynx > - OpenSSL > - ... maybe more ... SQLite seems to be another example.