Re: man page not found

Re: man page not found

[A Soare]

> Well, if I follow your initial example:
> 
> man dlopen
> 
> gives me:
> 
> DLOPEN(3) at the bottom of the page.
> 
> 3 is the section number, not page number, and it's the section number of the
> page I'm already looking at.

You are right. In fact, there is shown the title of the current man's page, so there is no need of a link...

Re: man page not found

[A Soare]

> 
> >>  > It would be better to have a link in order to jump faster with the mouse. If
> >>  > not, it is good so.
> >> 
> >> I don't understand your point.  Any link just leads to the page that you're
> >> already looking at, doesn't it?
> >
> > Of course not.
> >
> > I am on the page 1 or 2 or 8, etc, and in the bottom should be a link
> > to page 3.
> 
> I believe Nick was talking about the very link we will modify, i.e. the
> one in the footer. This one always points to the current page, so it's
> no use to bother with it.
> 
> I'll install this little modification later today if there's no
> objection.

No, now it was clarified. You can install it. One can see in the corner the title of the current page, so there is no need of a link.

Please install the patch.


Thank you.

Re: man page not found

[A Soare]

>  > It would be better to have a link in order to jump faster with the mouse. If
>  > not, it is good so.
> 
> I don't understand your point.  Any link just leads to the page that you're
> already looking at, doesn't it?

Of course not.

I am on the page 1 or 2 or 8, etc, and in the bottom should be a link to page 3.

There are many pages with the same name.

Alin Soare.

Re: man page not found

[Nick Roberts]

 > > I don't understand your point.  Any link just leads to the page that you're
 > > already looking at, doesn't it?
 > 
 > Of course not.
 > 
 > I am on the page 1 or 2 or 8, etc, and in the bottom should be a link to
 > page 3.
 > 
 > There are many pages with the same name.

Well, if I follow your initial example:

man dlopen

gives me:

DLOPEN(3) at the bottom of the page.

3 is the section number, not page number, and it's the section number of the
page I'm already looking at.


-- 
Nick                                           http://www.inet.net.nz/~nickrob

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 962 bytes --]

A Soare <alinsoar@voila.fr> writes:

>>  > It would be better to have a link in order to jump faster with the mouse. If
>>  > not, it is good so.
>> 
>> I don't understand your point.  Any link just leads to the page that you're
>> already looking at, doesn't it?
>
> Of course not.
>
> I am on the page 1 or 2 or 8, etc, and in the bottom should be a link
> to page 3.

I believe Nick was talking about the very link we will modify, i.e. the
one in the footer. This one always points to the current page, so it's
no use to bother with it.

I'll install this little modification later today if there's no
objection.

-- 
 |   Michaël `Micha' Cadilhac       |  Libertude,                            |
 |   http://michael.cadilhac.name   |        Égalitude,                      |
 |   JID/MSN:                       |             Fraternitude.              |
 `----  michael.cadilhac@gmail.com  |          -- À peu près S.R.       -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 345 bytes --]

Patch installed.

-- 
 |   Michaël `Micha' Cadilhac       |  In a World without Walls and Fences,  |
 |   http://michael.cadilhac.name   |     who needs Windows and Gates?       |
 |   JID/MSN:                       |          -- Dino Esposito              |
 `----  michael.cadilhac@gmail.com  |                                   -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[A Soare]

> Great.  Feel free to install your change, then,
> 

There is no possibility to find out the case looking at the word somewhere in the page?

It would be better to have a link in order to jump faster with the mouse. If not, it is good so.

Re: man page not found

[Stefan Monnier]

> There is no possibility to find out the case looking at the word somewhere
> in the page?

> It would be better to have a link in order to jump faster with the
> mouse. If not, it is good so.

Why would you want to follow this "link"?  It'd be a link to the page you're
reading already.


        Stefan

Re: man page not found

[Nick Roberts]

 > There is no possibility to find out the case looking at the word somewhere
 > in the page?
 > 
 > It would be better to have a link in order to jump faster with the mouse. If
 > not, it is good so.

I don't understand your point.  Any link just leads to the page that you're
already looking at, doesn't it?

-- 
Nick                                           http://www.inet.net.nz/~nickrob

Re: man page not found

[A Soare]

> 
> Does the following fix your bug? And is it acceptable?
> 

What I see is that there is no more a link there. It wouldn't be better to convert to the good case?

Anyway, it is better so than with a non working link.


Thanks.

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 793 bytes --]

A Soare <alinsoar@voila.fr> writes:

>> Does the following fix your bug? And is it acceptable?
>> 
>
> What I see is that there is no more a link there. It wouldn't be
> better to convert to the good case?

Well, it's not that easy. The good form cannot be predicted in general.

However, this last line is not in the same format in all man pages (but
it is always to be ignored, as it's a footer), so it may be difficult to
come with another solution.

-- 
 |   Michaël `Micha' Cadilhac       |  Un certain Blaise Pascal              |
 |   http://michael.cadilhac.name   |    etc... etc...                       |
 |   JID/MSN:                       |  -- Prévert (Les paris stupides)       |
 `----  michael.cadilhac@gmail.com  |                                   -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

man page not found

[A Soare]

1. emacs -Q

2. man RET

Manual entry: dlopen RET

3. goto bottom right to   DLOPEN(3) and press using mouse on this link.

Resul in *Messages*:

error in process sentinel: Man-bgproc-sentinel: Can't find the 3 DLOPEN manpage
error in process sentinel: Can't find the 3 DLOPEN manpage


However man RET Manual entry: 3 dlopen RET find the entry.

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 645 bytes --]

A Soare <alinsoar@voila.fr> writes:

> 1. emacs -Q
>
> 2. man RET
>
> Manual entry: dlopen RET
>
> 3. goto bottom right to   DLOPEN(3) and press using mouse on this link.

Well, there's no DLOPEN manual. There's a dlopen one.

The problem is just that there must be no link here. I'll see what
I can do.

-- 
 |   Michaël `Micha' Cadilhac       |  I cannot reproduce this bug,          |
 |   http://michael.cadilhac.name   |    but I have installed a change       |
 |   JID/MSN:                       |      which I think will fix it.        |
 `----  michael.cadilhac@gmail.com  |          -- Kim F. Storm          -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1.1: Type: text/plain, Size: 448 bytes --]

michael@cadilhac.name (Michaël Cadilhac) writes:

> A Soare <alinsoar@voila.fr> writes:
>
>> 1. emacs -Q
>>
>> 2. man RET
>>
>> Manual entry: dlopen RET
>>
>> 3. goto bottom right to   DLOPEN(3) and press using mouse on this link.
>
> Well, there's no DLOPEN manual. There's a dlopen one.
>
> The problem is just that there must be no link here. I'll see what
> I can do.

Does the following fix your bug? And is it acceptable?


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.1.2: man.patch --]
[-- Type: text/x-patch, Size: 904 bytes --]

Index: lisp/man.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/man.el,v
retrieving revision 1.167
diff -c -r1.167 man.el
*** lisp/man.el	24 Mar 2007 09:43:07 -0000	1.167
--- lisp/man.el	9 May 2007 11:17:29 -0000
***************
*** 1296,1302 ****
  	(forward-line 1))
      (if (re-search-forward Man-heading-regexp (point-max) t n)
  	(beginning-of-line)
!       (goto-char (point-max)))))
  
  (defun Man-previous-section (n)
    "Move point to Nth previous section (default 1)."
--- 1296,1304 ----
  	(forward-line 1))
      (if (re-search-forward Man-heading-regexp (point-max) t n)
  	(beginning-of-line)
!       (goto-char (point-max))
!       ;; The last line doesn't belong to any section.
!       (forward-line -1))))
  
  (defun Man-previous-section (n)
    "Move point to Nth previous section (default 1)."

[-- Attachment #1.1.3: Type: text/plain, Size: 327 bytes --]


-- 
 |   Michaël `Micha' Cadilhac       |  Une erreur peut devenir exacte        |
 |   http://michael.cadilhac.name   |     selon que celui qui l'a commise    |
 |   JID/MSN:                       |  s'est trompé ou non.                  |
 `----  michael.cadilhac@gmail.com  |          -- Pierre Dac            -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[Stefan Monnier]

> !       ;; The last line doesn't belong to any section.
> !       (forward-line -1))))

Are we 100% sure that the last line never belongs to any section?
Could we put at least some sanity check there.  E.g. it seems this
footer we want to skip always starts at column 0, so maybe we could just do

       (if (save-excursion (forward-line (if (bolp) -1 0))
                           (looking-at "[^ \t]"))
         ;; The last line is a footer.
         (forward-line -1))))


-- Stefan

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 1075 bytes --]

Stefan Monnier <monnier@iro.umontreal.ca> writes:

>> !       ;; The last line doesn't belong to any section.
>> !       (forward-line -1))))
>
> Are we 100% sure that the last line never belongs to any section?
> Could we put at least some sanity check there.  E.g. it seems this
> footer we want to skip always starts at column 0

It is not, many X11/Xm functions end with the name of the function
flushed to the right, for example.

In fact, the `.TH' command (which AFAIK is mandatory) only forces
something at the very right of the footer. I don't think its a good
thing to add an heuristic on that.

AFAIK, there's always a footer, so I'm 100% sure that the last line
never belongs to any section ; however, it's just IMHO.

-- 
 |   Michaël `Micha' Cadilhac       |  Isn't vi that text editor with        |
 |   http://michael.cadilhac.name   |   two modes... One that beeps and      |
 |   JID/MSN:                       |     one that corrupts your file?       |
 `----  michael.cadilhac@gmail.com  |           -- Dan Jacobson         -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[Stefan Monnier]

> AFAIK, there's always a footer, so I'm 100% sure that the last line
> never belongs to any section ; however, it's just IMHO.

Great.  Feel free to install your change, then,


        Stefan

Re: man page not found

[Richard Stallman]

Your patch is not bad, but it might be better to fix the code
that checks for a link.  After all, there are lots of ways
to move point to the end of the buffer, and if it looks like
there should be a link there, why not make it work as a link?

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 1146 bytes --]

Richard Stallman <rms@gnu.org> writes:

> Your patch is not bad, but it might be better to fix the code
> that checks for a link.  After all, there are lots of ways
> to move point to the end of the buffer, and if it looks like
> there should be a link there, why not make it work as a link?

Well, the link here is, on a GNU system at least, the concatenation of
the name of the program with its section. Problem is, the program name
is not always the name of the man page. For instance, zsh uses ZSH as
program name.

In the GNU man point-of-view, I'm pretty sure this is not meant to be
a link but a reminder, so we should not use it as such.

The only « other » fix I see is to change this link (detected as the one
in the footer) to alway point to the current page. However, I don't see
the use.

-- 
 |   Michaël `Micha' Cadilhac       |  Une erreur peut devenir exacte        |
 |   http://michael.cadilhac.name   |     selon que celui qui l'a commise    |
 |   JID/MSN:                       |  s'est trompé ou non.                  |
 `----  michael.cadilhac@gmail.com  |          -- Pierre Dac            -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Re: man page not found

[Michaël Cadilhac]

[-- Attachment #1.1: Type: text/plain, Size: 1361 bytes --]

michael@cadilhac.name (Michaël Cadilhac) writes:

> Richard Stallman <rms@gnu.org> writes:
>
>> Your patch is not bad, but it might be better to fix the code
>> that checks for a link.  After all, there are lots of ways
>> to move point to the end of the buffer, and if it looks like
>> there should be a link there, why not make it work as a link?
>
> Well, the link here is, on a GNU system at least, the concatenation of
> the name of the program with its section. Problem is, the program name
> is not always the name of the man page. For instance, zsh uses ZSH as
> program name.
>
> In the GNU man point-of-view, I'm pretty sure this is not meant to be
> a link but a reminder, so we should not use it as such.
>
> The only « other » fix I see is to change this link (detected as the one
> in the footer) to alway point to the current page. However, I don't see
> the use.

Should this be installed on EMACS_22_BASE too ? I'm not aware of the
commit procedure for this branch, and what should go into it.

-- 
 |   Michaël `Micha' Cadilhac       |   Je veut dire que la loi francaise    |
 |   http://michael.cadilhac.name   |           est overwritable par le      |
 |   JID/MSN:                       |    reglement interieur il me semble.   |
 `----  michael.cadilhac@gmail.com  |          -- ElBarto               -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel