I always use ## I rarely use # or ## When people send me code with consistent use of #, I can't read it because all the comments fly off to the right and are nowhere near what they are talking about.
On Thu, May 4, 2017 at 10:49 PM, Paul Johnson <pauljoh...@gmail.com> wrote: > Please raise your hand if you have EVER used # to document R code in > the way mentioned on the LISP coding standards page. > > pj > > On Thu, May 4, 2017 at 10:52 AM, Brahm, David > <david.br...@geodecapital.com> wrote: >> Since we're on the topic, is there a style to make the # comments >> right-justified against >> "fill-column" (which is 97 for me, as that makes printouts look good) and/or >> the window >> width? So as you type the comment, it marches leftward. E.g.: >> >> x <- y + z # This >> comment ends on column 97 >> 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567 >> >> -- David Brahm (br...@alum.mit.edu) >> >> >> -----Original Message----- >> From: ESS-help [mailto:ess-help-boun...@r-project.org] On Behalf Of Charles >> C. Berry >> Sent: Thursday, May 04, 2017 11:38 AM >> To: Ista Zahn >> Cc: Stephen Eglen; ess-help >> Subject: Re: [ESS] Ever consider changing indentation on #? >> >> On Thu, 4 May 2017, Ista Zahn wrote: >> >>> On Thu, May 4, 2017 at 10:25 AM, Lionel Henry <lionel....@gmail.com> wrote: >>>> >>>>> On 4 mai 2017, at 16:22, Paul Johnson <pauljoh...@gmail.com> wrote: >>>>> >>>>> I understand I can fix my init.el go avoid this, but it would be nicer >>>>> for my purpose >>>>> if this were in ESS itself, because I keep telling students to use it >>>>> and they are put off/discouraged >>>>> by this. >>>> >>>> Emacs is for people willing to put the effort into customisation. >>>> Your students are probably better off with RStudio. That said >>>> I agree that good defaults are important. >>> >> >> And there are a bunch of styles from which to choose a personal default. >> See below. >> >>> Yes, IMO Emacs/ESS isn't going to compete with Rstudio on >>> out-of-the-box convenience. But we can compete on features! Put this >>> in your config file >>> >>> (add-hook 'ess-mode-hook >>> (lambda() >>> ;; don't indent comments >>> (setq ess-indent-with-fancy-comments nil) >>> ;; turn on outline mode >>> (setq-local outline-regexp "[# ]+") >>> (outline-minor-mode t))) >>> >>> and not only will single # comments not be aligned at comment-column, >>> but code folder will work too! >>> >>> >> >> There are `off-the-shelf' styles like `Rstudio' that might satisfy Paul's >> student. >> >> Setting `ess-default-style' to `Rstudio' gives these settings: >> >> (RStudio >> (ess-indent-offset . 2) >> (ess-offset-arguments . open-delim) >> (ess-offset-arguments-newline . prev-line) >> (ess-offset-block . prev-line) >> (ess-offset-continued . straight) >> (ess-align-nested-calls) >> (ess-align-arguments-in-calls "function[ ]*(") >> (ess-align-continuations-in-calls) >> (ess-align-blocks) >> (ess-indent-from-lhs arguments) >> (ess-indent-from-chain-start . t) >> (ess-indent-with-fancy-comments)) >> >> >> Or one can customize the `OWN' style and select it. See the >> `ess-style-alist' docstring for more details. >> >> HTH, >> >> Chuck >> >> ______________________________________________ >> ESSfirstname.lastname@example.org mailing list >> https://stat.ethz.ch/mailman/listinfo/ess-help >> >> ______________________________________________ >> ESSemail@example.com mailing list >> https://stat.ethz.ch/mailman/listinfo/ess-help > > > > -- > Paul E. Johnson http://pj.freefaculty.org > Director, Center for Research Methods and Data Analysis http://crmda.ku.edu > > To write to me directly, please address me at pauljohn at ku.edu. > > ______________________________________________ > ESSfirstname.lastname@example.org mailing list > https://stat.ethz.ch/mailman/listinfo/ess-help ______________________________________________ ESSemail@example.com mailing list https://stat.ethz.ch/mailman/listinfo/ess-help