Re: tips/tools for ReSpec-to-Bikeshed conversion?

"Hodges, Jeff" <[email protected]> Tue, 8 Mar 2016 15:32:03 +0000
Newsgroups gmane.org.w3c.specifications
Message-ID <D3042F9C.8FB46%[email protected]>
On 3/7/16, 4:55 PM, "Tab Atkins Jr." <[email protected]<mailto:[email protected]>> wrote:

On Mon, Mar 7, 2016 at 4:43 PM, Hodges, Jeff <[email protected]<mailto:[email protected]>> wrote:
installed pygments per one of the bikeshed error msgs

It sounds like you didn't follow the installation instructions
<https://github.com/tabatkins/bikeshed/blob/master/docs/install.md>
linked from the README.  You're probably fine by now, but I find that
people often run into problems because they cowboy'd the installation
and missed some important steps. ^_^

AFAIK I correctly followed the installation.



FATAL ERROR: Found unmatched text macro [DOM4]. Correct the macro, or
escape it with a leading backslash.
FATAL ERROR: Found unmatched text macro [HTML5]. Correct the macro, or
escape it with a leading backslash.
FATAL ERROR: Found unmatched text macro [RFC2119]. Correct the macro, or
escape it with a leading backslash.
FATAL ERROR: Found unmatched text macro [PSL]. Correct the macro, or
escape it with a leading backslash.

These are because strings like "[FOO]" are recognized by Bikeshed as
text macros,

yeah, they're in there cuz i fed poor bikeshed respec output which contains what it thinks are macros (they're citations)

in any case, further munging of the input with a regex-capable editor will likely smooth things out.

thx

=JeffH