SliTaz Forum

man & retawq

(9 posts) (3 voices)

• Started 8 years ago by llev
• Latest reply from Aleksej
• This topic is not a support question

Tags:

No tags yet.

1. 

   llev
   

   offline

   Member

   Hi,

   I'm working on another revision of SliTaz's fake man, it will be faster to find relevant sections if they are not specified, and use a more complete source of man pages (linux.die.net).

   I've come to wonder why, in order to display local html docs, we request retawq only to run retawq --dump, loosing all html markup & links... Since we're making a fake man, why not launch retawq for good if it is available?

   Posted 8 years ago #
2. 

   Aleksej
   

   offline

   Coder-hobbyist

   Hi Lucas,

   Retawq is nice and small. It gives good results when browsing linux.die.net man pages:

   retawq linux.die.net/man/1/ash

   

   The only problem for me: how to exit it?? :-D
   Ctrl+Z ?

   In other hand, retawq not supported UTF-8. Really? Yes.
   We can use man to read local documentation in HTML format:

   man tazpkg

   

   Here, as I found from /usr/share/man sources, HTML is dumped using retawq. The only problem here is: lines of text is half-filled because text is in UTF-8 and each Cyrillic symbol here takes two bytes.

   Let's direct open that HTML page in retawq:
   

   retawq file:///usr/share/doc/tazpkg/tazpkg.ru.html

   

   Oh, no.

   To summarize. The using of retawq is limited. You can use it to display English man pages from linux.die.net (but how to exit it?:)
   But it is better not to use it everywhere in /usr/share/man.

   Also, please take a look at my (weird) script in which I convert local HTML page to display it in the terminal:
   

   tazpkg -h gi

   Regular expression is a "heart" of this script: http://hg.slitaz.org/tazpkg/file/879df9728956/modules/help#l140

   Posted 8 years ago #
3. 

   Ceel
   

   offline

   Administrator

   Hi Aleksej,

   The only problem for me: how to exit it??

   Hit the M key -> opens the context menu.
   Then select Quit :-D

   EDIT: or uppercase Q

   Posted 8 years ago #
4. 

   llev
   

   offline

   Member

   
   Oh, no.

   LOL!

   OK, so if retawq is available I'll use it to display online manpages, otherwise just to dump text.
   If it's not, I can use your regexp to translate HTML to text. For online pages, w3.org offers a translation service that's not bad: http://www.w3.org/services/html2txt .

   Posted 8 years ago #
5. 

   Aleksej
   

   offline

   Coder-hobbyist

   :)

   Note, regexp is far from ideal :( It not processes unordered lists (that I added to html later, after I finished to develop regexp):
   

   <ul>
     <li>...</li>
     <li>...</li>
   </ul>

   You can find the bug executing next command:
   

   tazpkg -h convert

   Posted 8 years ago #
6. 

   llev
   

   offline

   Member

   Noted, but I'm not sure I'd be able to patch it, it's so complicated. Maybe a small list of the meaning of your control codes (A^H etc.) would help.

   Posted 8 years ago #
7. 

   Aleksej
   

   offline

   Coder-hobbyist

   OK, I'll write a couple of lines in the README.devel.

   PS: http://hg.slitaz.org/tazpkg/rev/bbc6b0a453a7

   Posted 8 years ago #
8. 

   llev
   

   offline

   Member

   Hi Aleksej,

   Very nice "couple" of lines! I see you support description lists, do you plan to use them in the doc? (I see none in tazpkg.html.)

   Posted 8 years ago #
9. 

   Aleksej
   

   offline

   Coder-hobbyist

   Hi Lucas,

   No, I planned it early.
   We can use the same code to get command line help in other SliTaz tools where dl may be useful.

   Posted 8 years ago #

RSS feed for this topic

Reply

You must log in to post.