On 25 February 2014 11:40, Gene Cumm <[email protected]> wrote:
> On Mon, Feb 24, 2014 at 7:03 PM, Lex Trotman <[email protected]> wrote:
>> On 25 February 2014 07:50, Gene Cumm <[email protected]> wrote:
>>> In the Name line ("command - description here"), can the font of 1+
>>> words be adjusted to strong?  I've tried it and not having luck.  Is
>>> this a bug or a limitation of the manpage standard?
>>
>> It seems to be a limitation of the docbook-xsl, manually adding
>> emphasis to the name in the docbook still produced the same roff:
>>
>> .SH "NAME"
>> asciidoc \- converts an AsciiDoc text file to HTML or DocBook
>
> asciidoc hello.txt
>
> -- hello.txt begin
> = hello(1) =
> :doctype: manpage
>
> == NAME ==
> hello - hello *world*
>
> == SYNOPSIS ==
> hello
>
> == Description ==
> Say hello and greet the world
>
> -- hello.txt end
>
> This results in the '*' making it into the resulting HTML.  removing
> the doctype line results in strong text.  I'm sorry I wasn't clearer
> last time.
>
>> The content of the NAME section needs special (hardcoded) processing
>> to split it into names and purpose to go in the appropriate docbook
>> entities.  To make this simpler, and presumably since the xsl doesn't
>> handle markup in names, no markup is handled in name and purpose
>> fields.
>
> Given the example, does this still apply?

Well, yes, the *world* is in the purpose text, so no markup.

>
>> I didn't examine if roff would handle it, if it was generated.
>
> Manually forcing a word to bold seems to work with man on my system.

It still needs changes in the asciidoc code to recognise and translate
markup in the purpose text.

Or since it isn't translated, you could add the <emphasis></emphasis>
markup directly to the purpose.

Cheers
Lex

>
> --
> -Gene
>
>> So there are at least two roadblocks to marking up the name and purpose.
>>
>> Cheers
>> Lex
>>
>>>
>>> --
>>> -Gene
>
> --
> You received this message because you are subscribed to the Google Groups 
> "asciidoc" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/asciidoc.
> For more options, visit https://groups.google.com/groups/opt_out.

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to