Ingo Schwarze wrote: > 2. When calling "mandoc -T html" without specifying "-O style=", > fall back to "-O style=/var/www/htdocs/mandoc.css" by default. > That might be sensible because it is adequate for local > viewing of the file, which is likely intended with files > generated in such a manual way.
I think this is probably not true. I would guess people are running mandoc -T html to generate static files for a web server. I would suggest using a relative URL here, just "mandoc.css", so the files can be copied around and viewed by people not running OpenBSD. But see below. Local OpenBSD users are probably just using the text tty output of man. > 1. Install /var/www/htdocs/mandoc.css by default. I think this is a bad idea. > 2. Make "-O style=/var/www/htdocs/mandoc.css" the default in mandoc(1). Maybe, maybe not, but as above, I'd argue for simply "mandoc.css". However, I don't think we really need to make changes here. > 3. Inline your version if the user says "-O style=''". I would say just inline this by default. Leave the behavior of -O alone. So: 1. Reduce the full style to a minimal version. Embed that. 2. Done. :) If you agree it won't be too much burden moving forward, I can make a diff shortly.
