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.
