[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-kdoc
Subject:    Re: kdoc-list doesn't work
From:       Wolfgang Bangerth <wolf () gaia ! IWR ! Uni-Heidelberg ! De>
Date:       1999-03-25 17:52:38
[Download RAW message or body]


> I do not know what is going on but I'm subscribed to kdoc-list and I got
> this message but this is the first message from this list for at least
> one month.

Hm, right, I should have noticed that. However, since it seems to work
again, I resend the two patches I sent to this list within the last month
or so...

Regards
  Wolfgang

-------------------------------------------------------------------------
Wolfgang Bangerth            email:       wolf@gaia.iwr.uni-heidelberg.de
                             www: http://gaia.iwr.uni-heidelberg.de/~wolf



#1:
At present, multiple newlines are considered as paragraph break, which
seems reasonable. However, the regexp to find these is
  $Description =~ s/\n\n+/\n<\/p><p>\n/g;
(it appears twice in kdocHTML.pm), which might be replaced by
  $Description =~ s/\n(\s*\n)+/\n<\/p><p>\n/g;
to catch lines containing only whitespace also.



#2:
in my version of kdoc, the data type of member variables was not allowed
to contain template specifications and ::. Sure enough, I had to change
this, the patch is below. Maybe it is of some help to anyone.


Index: kdoc
===================================================================
RCS file: /home/people/cvs/deal/doc/auto/scripts/kdoc/kdoc,v
retrieving revision 1.3
retrieving revision 1.5
diff -c -5 -r1.3 -r1.5
*** kdoc	1999/02/22 13:11:07	1.3
--- kdoc	1999/03/19 17:22:37	1.5
***************
*** 1,10 ****
  #!/usr/local/bin/perl
  
  # Documentation generator. 
  # Torben Weis (weis@kde.org) and Sirtaj Kang (taj@kde.org)
! # $Id: kdoc,v 1.3 1999/02/22 13:11:07 wolf Exp $
  
  #    This program is free software; you can redistribute it and/or modify
  #    it under the terms of the GNU General Public License as published by
  #    the Free Software Foundation; either version 2 of the License, or
  #    (at your option) any later version.
--- 1,10 ----
  #!/usr/local/bin/perl
  
  # Documentation generator. 
  # Torben Weis (weis@kde.org) and Sirtaj Kang (taj@kde.org)
! # $Id: kdoc,v 1.5 1999/03/19 17:22:37 wolf Exp $
  
  #    This program is free software; you can redistribute it and/or modify
  #    it under the terms of the GNU General Public License as published by
  #    the Free Software Foundation; either version 2 of the License, or
  #    (at your option) any later version.
***************
*** 443,456 ****
  		# dont do anything
  	}
  
  
  	#### Variables
! 	elsif ( /^[^\(]*$/ && /^[\w_\:\s]+[\&\s*]+[\w_]+\s*(\[[^\]]*\])*\s*;\s*(\/\/.*)?$/ \
                )
! 	    #       1               2        3      4           5                 6
  	    # 1: variable declarations have no ()
! 	    # 2: data type, possibly several words as in 'unsigned int'
  	    # 3: reference pointer or at least a space before variable name
  	    # 4: variable name
  	    # 5: array declaration
  	    # 6: spaces and or comments
  	{
--- 443,457 ----
  		# dont do anything
  	}
  
  
  	#### Variables
! 	elsif ( /^[^\(]*$/ && \
/^(?:[\w_\:\s]+(?:<(?:(?:[-\w,_\s]|<(?:[-\w,+\s])+>)+)>)?(?:::)?)[\&\s*]+[\w_]+\s*(\[[^\]]*\])*\s*;\s*(\/\/.*)?$/ \
                )
! 	    #       1               2                                                      \
3      4           5                 6  # 1: variable declarations have no ()
! 	    # 2: data type, possibly several words as in 'unsigned int' and
! 	    #    maybe containing templates <...> and ::
  	    # 3: reference pointer or at least a space before variable name
  	    # 4: variable name
  	    # 5: array declaration
  	    # 6: spaces and or comments
  	{


[prev in list] [next in list] [prev in thread] [next in thread]