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
>>
>> ______________________________________________
>> 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