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

 
 

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

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

Add a New Comment Rich Markup
   

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>
Group administrator
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 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>
Group administrator
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)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    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.13-3230.
    Corresponding source code