Since I started Elisp programming, I've always wondered why there is
an opposition between the following lines of the manual:

 -- Macro: defcustom option standard doc [keyword value]...
     [...]There is no need to start [the docstring] with a `*'

and these lines of shell:

  mistral% cd ~/src/emacs/lisp
  mistral% echo; cat grep.awk; echo
  
  BEGIN { grepped=0 }
  /^\(defcustom/ { grepped=1 ; next }
  /^ *"[*]/ { if (grepped==1) { print (FILENAME, ":", NR) } }
  { grepped=0 }
  
  mistral% { for f (**/*.el) awk -f grep.awk $f } | wc -l
  3011
  
(this is 3011 matches of bad-style according to the doc)

Is there any reason ? I see patches like
http://thread.gmane.org/gmane.emacs.devel/38098
going to the trunk, so I don't know.

-- 
 |      Michaël `Micha' Cadilhac     |  Pour les 35-40 ans, l'humour          |
 |         Epita/LRDE Promo 2007     |       c'est une plus-value.            |
 |  http://michael.cadilhac.name     |          -- Guillaume L.               |
 `--JID: michael.cadilhac@gmail.com--'                                   -  --'