From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sebastien Vauban Subject: Re: [patch, ox] Unnumbered headlines Date: Fri, 03 Oct 2014 10:49:44 +0200 Message-ID: <867g0hedw7.fsf@example.com> References: <87lhqzyubg.fsf@gmx.us> <87bnrrp0tb.fsf@nicolasgoaziou.fr> <87r40n6nrg.fsf@gmx.us> <87egwmaxte.fsf@nicolasgoaziou.fr> <87k34y701i.fsf@gmx.us> <87fvfl86ct.fsf@nicolasgoaziou.fr> <87k34xghtt.fsf@gmx.us> <87ppeon4mw.fsf@nicolasgoaziou.fr> <87tx4020lh.fsf@gmx.us> <87vboflkil.fsf@nicolasgoaziou.fr> <87iokfdvi3.fsf@gmx.us> <87d2aiesce.fsf@nicolasgoaziou.fr> <87lhp0iusr.fsf@pank.eu> <87iok1twl4.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org-mXXj517/zsQ@public.gmane.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org-mXXj517/zsQ@public.gmane.org To: emacs-orgmode-mXXj517/zsQ@public.gmane.org Nicolas Goaziou wrote: >> + ;; Test if destination is a numbered headline > > Missing full stop. Small question about conventions for writing comments... Can I consider the following to be the rule? - If it's a *sentence* (like the above example, in the imperative form), begin with a capital and end with a dot. - Otherwise (like ";; pattern found"), begin with a small letter and don't end with a dot. ? Tips on writing comments found on https://www.gnu.org/software/emacs/manual/html_node/elisp/Comment-Tips.html aren't very helpful IMHO, as you see things such as: - "; there was there was a base version to which this looks like a subversion", that is a sentence with no capital nor dot... - ";; Update mode line.", that is a sentence with both beginning capital and to. - ";;;; The kill ring", an expression with a capital... That page seems to be more on the usage of ";", ";;", ";;;" and ";;;;" than on the usage of capitals and dots. Best regards, Seb -- Sebastien Vauban