Re: [changeset] Re: [manual] In prepad, add reference to postpad.

[Thorsten Meyer]

John W. Eaton wrote:
> On  1-Jan-2009, Thorsten Meyer wrote:
> 
> | Hi,
> | 
> | Francesco Potortì wrote:
> | > # HG changeset patch
> | > # User Francesco Potortì <address@hidden>
> | > # Date 1230328478 -3600
> | > # Node ID 6fa32fc22e5b1c9b84cbcc5ce7ab5d727b42adc5
> | > # Parent  fcc46267f239ad0199b9fa26407c1d41efeae862
> | > In prepad, add reference to postpad.
> | > 
> | > diff -r fcc46267f239 -r 6fa32fc22e5b scripts/ChangeLog
> | > --- a/scripts/ChangeLog   Fri Dec 26 22:51:48 2008 +0100
> | > +++ b/scripts/ChangeLog   Fri Dec 26 22:54:38 2008 +0100
> | > @@ -1,4 +1,6 @@ 2008-12-26  Francesco Potortì  <address@hidden
> | >  2008-12-26  Francesco Potortì  <address@hidden>
> | > +
> | > + * general/prepad.m: Add reference to postpad.
> | >  
> | >   * general/postpad.m: Use @seealso.  Add reference to resize.
> | >  
> | > diff -r fcc46267f239 -r 6fa32fc22e5b scripts/general/prepad.m
> | > --- a/scripts/general/prepad.m    Fri Dec 26 22:51:48 2008 +0100
> | > +++ b/scripts/general/prepad.m    Fri Dec 26 22:54:38 2008 +0100
> | > @@ -33,6 +33,7 @@
> | >  ##
> | >  ## If the optional @var{dim} argument is given, then operate along this
> | >  ## dimension.
> | > +## @seealso{postpad}
> | >  ## @end deftypefn
> | >  
> | >  ## Author: Tony Richardson <address@hidden>
> | > 
> | as it is, this patch breaks the documentation, because there is no anchor 
> for the postpad
> | documentation (so the seealso reference to postpad points nowhere).
> | 
> | Attached is a patch that adds an anchor for postpad.
> | 
> | However, I am not sure if this should be applied: the actual documentation 
> of the postpad function
> | is in the documentation string for prepad. So the seealso reference to 
> postpad would be a self
> | reference.
> | 
> | What do you think?
> 
> Does the anchor cause a problem?
> 
technically: no.

Just the resulting seealso{postpad} reference in the documentation is of 
limited use like this, as
it will point back to the same documentation string.

regards

Thorsten