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: documentationSeverity: 3 - Normal
Item Group: documentationStatus: Invalid
Privacy: PublicAssigned to: Sebastien Helleu <flashcode>
Originator Name: Open/Closed: Closed
Release: 0.4.0IRC nick: esr

Add a New Comment (Rich MarkupRich 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 File(s):
   
   
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
  • -unavailable- added by flashcode (Posted a comment)
  • -unavailable- added by esr (Submitted the item)
  •  

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

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 6 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Sun 06 Oct 2013 07:40:20 AM UTCflashcodeOpen/ClosedOpen=>Closed
    Sat 20 Jul 2013 05:53:49 AM UTCflashcodeStatusNeed Info=>Invalid
    Mon 17 Jun 2013 04:43:44 PM UTCesrAttached File-=>Added weechat-curses.1.patch, #28335
    Mon 10 Jun 2013 09:42:04 AM UTCflashcodeStatusNone=>Need Info
      Assigned toNone=>flashcode
    Sun 09 Jun 2013 02:37:29 PM UTCesrAttached File-=>Added weechat-curses.1.patch, #28284

    Back to the top


    Powered by Savane 3.1-cleanup