From: Kristaps Dzonsons <kristaps@bsd.lv>
To: "tech@mdocml.bsd.lv" <tech@mdocml.bsd.lv>
Subject: Bk -words badness
Date: Mon, 05 Jul 2010 11:18:33 +0200 [thread overview]
Message-ID: <4C31A369.6010005@bsd.lv> (raw)
Ingo, how goes the `Bk' work? Scanning through mandoc's rendering of
current manuals, I see a lot of the following sort of breakage:
.Bk -words
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
.Op Fl a Ar b
...
Which will, for obvious reasons, continue eternally past rmargin.
I have an intuition for how to implement an implied `Bk' for all
SYNPRETTY blocks: to hook into print_mdoc_node() and set/unset the
PREKEEP flag depending on the line number as reported in mdoc_node.
Would this sort of behaviour satisfy you? The effect would be:
<PREKEEP>.Op Fl a Ar b<UNKEEP>
<PREKEEP>.Op Fl a Ar b<UNKEEP>
...etc.
The `Bk' handler would then be responsible for simply setting the flag
that would be OR'd in print_mdoc_node() for keeps (SYNPRETTY|KEEPPRETTY
or whatever).
This way, we can simply say that SYNOPSIS implies a `Bk -words' for the
entire section (i.e., SYNPRETTY) and that `Bk -words' means that
contained macro lines aren't space-broken between words.
Thoughts?
Kristaps
--
To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv
next reply other threads:[~2010-07-05 9:18 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-07-05 9:18 Kristaps Dzonsons [this message]
2010-07-05 10:35 ` Kristaps Dzonsons
2010-07-05 11:03 ` Kristaps Dzonsons
2010-07-05 22:09 ` Ingo Schwarze
2010-07-06 9:40 ` Kristaps Dzonsons
2010-07-06 22:30 ` Ingo Schwarze
2010-07-05 22:27 ` Ingo Schwarze
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4C31A369.6010005@bsd.lv \
--to=kristaps@bsd.lv \
--cc=tech@mdocml.bsd.lv \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).