bugWeeChat - Bugs: bug #39212, Manual page didn't use URL macro -...

 
 

bug #39212: Manual page didn't use URL macro - fix patch attached

Submitted by:  Eric S. Raymond <esr>
Submitted on:  Sun 09 Jun 2013 02:37:29 PM UTC  
 
Category:  documentation Severity:  3 - Normal
Item Group:  documentation Status:  Invalid
Privacy:  Public Assigned to:  Sebastien Helleu <flashcode>
Originator Name:  Open/Closed:  Closed
Release:  0.4.0 IRC nick:  esr

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Tue 02 Jul 2013 06:53:10 PM UTC, comment #4:

Hi Eric,

Thanks for the new patch.
In fact during the meanwhile, I translated man page, which is now generated with asciidoc (and it can be used to build HTML page, where URLs are OK for me).

So I think this bug can be closed.

Sebastien Helleu <flashcode>
Project AdministratorIn charge of this item.
Mon 17 Jun 2013 04:43:44 PM UTC, comment #3:

After looking into the matter, I now think using .URL is a mistake which I should not have encouraged. The .UR and .UE macros, previously documented in groff_man(7) but not on the Unix man(7) page, are probably portable to more manual browsers. I've submitted a patch for man(7).

I've enclosed a simpler patch that should work better.

(file #28335)

Eric S. Raymond <esr>
Mon 10 Jun 2013 04:39:08 PM UTC, comment #2:

That's disturbing. I''ll experiment...

OK, I think I found the problem. Try inserting this text from man(7) early in the page:

.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso http://www.tmac

It seems I should have included that in my patch.

Eric S. Raymond <esr>
Mon 10 Jun 2013 09:42:04 AM UTC, comment #1:

Hi Eric,

Thank you for the patch.

I tested it and the result is that a conversion to HTML works fine with the URL macro, but the URLs are not visible any more with "man weechat-curses" (I'm testing on Debian Sid).

Is there another way to fix the URLs in HTML for man pages?

Sebastien Helleu <flashcode>
Project AdministratorIn charge of this item.
Sun 09 Jun 2013 02:37:29 PM UTC, original submission:

There's a .URL macro in the man(7) set. Using it allows generation of better HTML from the man page. Patch attached.

Eric S. Raymond <esr>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files
file #28335:  weechat-curses.1.patch added by esr (669B - text/x-diff)
file #28284:  weechat-curses.1.patch added by esr (609B - text/x-diff)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by flashcode (Posted a comment)
  • -email is unavailable- added by esr (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2013-10-06 flashcode Open/ClosedOpen => Closed
    2013-07-20 flashcode StatusNeed Info => Invalid
    2013-06-17 esr Attached File- => Added weechat-curses.1.patch, #28335
    2013-06-10 flashcode StatusNone => Need Info
        Assigned toNone => flashcode
    2013-06-09 esr Attached File- => Added weechat-curses.1.patch, #28284

    Back to the top


    Powered by Savane 3.3