tech@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: Ingo Schwarze <schwarze@usta.de>
To: tech@mdocml.bsd.lv
Cc: jmc@openbsd.org
Subject: Re: mdocml: Basic implementation of .Bk/.Ek; from OpenBSD.
Date: Sun, 27 Jun 2010 16:34:01 +0200	[thread overview]
Message-ID: <20100627143401.GB19398@iris.usta.de> (raw)
In-Reply-To: <4C271923.6070407@bsd.lv>

Hi Kristaps,

> Remember the mdoc.7 entries!

Sorry for forgetting; this is now done.

> All usages of `Bk' seem to use `-words'.

Right, and it is documented accordingly:

  More work needs to be done with the keep macros;
  a -line option needs to be added.  -- from mdoc.samples

This is correct except that "-line" ought to read "-lines".

> Does not using this flag change the macros behaviour?

Here is old groff's behaviour:

  no arg: Usage: .Bk [-lines | -words] (#13) and ignoring .Bk
  -lines: Not implemented yet. (#47) and ignoring .Bk
  -line: No error message and ignoring .Bk

Here is new groff's behavious:

  no arg: no error message, and assuming -words
  -lines: Not implemented yet. (#21) and assuming -words
  -line: no error message, and assuming -words

Great, isn't it?
  
So, here is a patch to
 * not print invalid arguments verbatim (no groffs prints them, either)
 * not trigger TERMP_PREKEEP twice
 * not die from invlid arguments (groff won't die, either)
 * continue to ignore even valid arguments (just like groff)

OK?


Index: mdoc_term.c
===================================================================
RCS file: /cvs/src/usr.bin/mandoc/mdoc_term.c,v
retrieving revision 1.90
diff -u -p -r1.90 mdoc_term.c
--- mdoc_term.c	27 Jun 2010 01:24:02 -0000	1.90
+++ mdoc_term.c	27 Jun 2010 14:15:31 -0000
@@ -2104,8 +2104,17 @@ static int
 termp_bk_pre(DECL_ARGS)
 {
 
-	p->flags |= TERMP_PREKEEP;
-	return(1);
+	switch (n->type) {
+	case (MDOC_BLOCK):
+		return(1);
+	case (MDOC_HEAD):
+		return(0);
+	case (MDOC_BODY):
+		p->flags |= TERMP_PREKEEP;
+		return(1);
+	default:
+		abort();
+	}
 }
 
 
@@ -2114,7 +2123,8 @@ static void
 termp_bk_post(DECL_ARGS)
 {
 
-	p->flags &= ~(TERMP_KEEP | TERMP_PREKEEP);
+	if (MDOC_HEAD == n->type)
+		p->flags &= ~(TERMP_KEEP | TERMP_PREKEEP);
 }
 
 /* ARGSUSED */
Index: mdoc_validate.c
===================================================================
RCS file: /cvs/src/usr.bin/mandoc/mdoc_validate.c,v
retrieving revision 1.61
diff -u -p -r1.61 mdoc_validate.c
--- mdoc_validate.c	26 Jun 2010 17:56:43 -0000	1.61
+++ mdoc_validate.c	27 Jun 2010 14:15:32 -0000
@@ -103,7 +103,7 @@ static	int	 pre_ss(PRE_ARGS);
 
 static	v_post	 posts_an[] = { post_an, NULL };
 static	v_post	 posts_at[] = { post_at, NULL };
-static	v_post	 posts_bd[] = { hwarn_eq0, bwarn_ge1, NULL };
+static	v_post	 posts_bd_bk[] = { hwarn_eq0, bwarn_ge1, NULL };
 static	v_post	 posts_bf[] = { hwarn_le1, post_bf, NULL };
 static	v_post	 posts_bl[] = { bwarn_ge1, post_bl, NULL };
 static	v_post	 posts_bool[] = { eerr_eq1, ebool, NULL };
@@ -150,7 +150,7 @@ const	struct valids mdoc_valids[MDOC_MAX
 	{ NULL, posts_notext },			/* Pp */ 
 	{ pres_d1, posts_wline },		/* D1 */
 	{ pres_d1, posts_wline },		/* Dl */
-	{ pres_bd, posts_bd },			/* Bd */
+	{ pres_bd, posts_bd_bk },			/* Bd */
 	{ NULL, NULL },				/* Ed */
 	{ pres_bl, posts_bl },			/* Bl */ 
 	{ NULL, NULL },				/* El */
@@ -241,7 +241,7 @@ const	struct valids mdoc_valids[MDOC_MAX
 	{ NULL, NULL },				/* Fc */ 
 	{ NULL, NULL },				/* Oo */
 	{ NULL, NULL },				/* Oc */
-	{ NULL, posts_wline },			/* Bk */
+	{ NULL, posts_bd_bk },			/* Bk */
 	{ NULL, NULL },				/* Ek */
 	{ NULL, posts_eoln },			/* Bt */
 	{ NULL, NULL },				/* Hf */

--
 To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv

       reply	other threads:[~2010-06-27 14:34 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <201006270126.o5R1QL1S015718@krisdoz.my.domain>
     [not found] ` <4C271923.6070407@bsd.lv>
2010-06-27 14:34   ` Ingo Schwarze [this message]
2010-06-27 17:00     ` Kristaps Dzonsons
2010-06-27 17:04       ` 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=20100627143401.GB19398@iris.usta.de \
    --to=schwarze@usta.de \
    --cc=jmc@openbsd.org \
    --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).