Allow me to present the latest and most hip source code header, developed by grubba, jhs and me (derived from work of hubbe and others). An example from backend.cmod:
/*\ -*- c -*- ||| This file is part of Pike. For copyright information see COPYRIGHT. ||| Pike is distributed under GPL, LGPL and MPL. See the file COPYING ||| for more information. ||| $Id: backend.cmod,v 1.28 2002/10/09 22:23:38 nilsson Exp $ */ /**/
First of all the header has a digital "frame" to the left that makes it easy (less hard) to make batch updates in the future. Taking a closer look on a row basis, we can see that all cmod files now has an emacs mode marker on the first line. The second line informs about the context of the file and where copyright claims are listed. The next two lines includes a license summary and a reference for further studies, followed by a CVS id line. The last three (!) lines contains the end token for the information block, a workaround for a font lock bug and finally one empty line before the actual code. I expect to have the final version in all C-related files during the day.
It will still break xemacs, though. Please avoid having a \ before the end-comment character.
/ Per Hedbor ()
Previous text:
2002-10-10 04:02: Subject: Source header
Allow me to present the latest and most hip source code header, developed by grubba, jhs and me (derived from work of hubbe and others). An example from backend.cmod:
/*\ -*- c -*- ||| This file is part of Pike. For copyright information see COPYRIGHT. ||| Pike is distributed under GPL, LGPL and MPL. See the file COPYING ||| for more information. ||| $Id: backend.cmod,v 1.28 2002/10/09 22:23:38 nilsson Exp $ */ /**/
First of all the header has a digital "frame" to the left that makes it easy (less hard) to make batch updates in the future. Taking a closer look on a row basis, we can see that all cmod files now has an emacs mode marker on the first line. The second line informs about the context of the file and where copyright claims are listed. The next two lines includes a license summary and a reference for further studies, followed by a CVS id line. The last three (!) lines contains the end token for the information block, a workaround for a font lock bug and finally one empty line before the actual code. I expect to have the final version in all C-related files during the day.
/ Martin Nilsson (Fake Build Master)
Ah. Thus the ending /* */.
Isn't it better to just skip those extra :s?
/* -*- c -*- || This file is part of Pike. For copyright information see COPYRIGHT. || Pike is distributed under GPL, LGPL and MPL. See the file COPYING || for more information. || $Id: backend.cmod,v 1.28 2002/10/09 22:23:38 nilsson Exp $ */
/ Per Hedbor ()
Previous text:
2002-10-10 09:07: Subject: Source header
It will still break xemacs, though. Please avoid having a \ before the end-comment character.
/ Per Hedbor ()
In XEmacs 21.5 (which is what is installed on pelix), it works even without the /**/. Which version does it break with?
/ Marcus Comstedt (ACROSS) (Hail Ilpalazzo!)
Previous text:
2002-10-10 09:08: Subject: Source header
Ah. Thus the ending /* */.
Isn't it better to just skip those extra :s?
/* -*- c -*- || This file is part of Pike. For copyright information see COPYRIGHT. || Pike is distributed under GPL, LGPL and MPL. See the file COPYING || for more information. || $Id: backend.cmod,v 1.28 2002/10/09 22:23:38 nilsson Exp $ */
/ Per Hedbor ()
pike-devel@lists.lysator.liu.se
-
Marcus Comstedt (ACROSS) (Hail Ilpalazzo!) ＠ Pike (-) developers forum -
Martin Nilsson (Fake Build Master) ＠ Pike (-) developers forum
-
Per Hedbor () ＠ Pike (-) developers forum