As an old lisp programmer I use # and ## and ### in all my code.

### ####################################
### for code block and function headers
### (this was actually functional in 
###  SPLUS for auto-generating help)
### ####################################

    ## for inline comments in code, and       # brief margin notes

I find it useful, but all things change over time.


Steven McKinney


> -----Original Message-----
> From: ESS-help [mailto:ess-help-boun...@r-project.org] On Behalf Of Paul
> Johnson
> Sent: May-04-17 7:50 PM
> To: ess-help
> Subject: Re: [ESS] Ever consider changing indentation on #?
> 
> 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
> >
> 123456789012345678901234567890123456789012345678901234567890123456789012345
> 6789012345678901234567
> >
> > -- 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
> >
> > ______________________________________________
> > ESS-help@r-project.org mailing list
> > https://stat.ethz.ch/mailman/listinfo/ess-help
> >
> > ______________________________________________
> > ESS-help@r-project.org 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.
> 
> ______________________________________________
> ESS-help@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/ess-help

______________________________________________
ESS-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/ess-help

Reply via email to