all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Stefan Monnier <monnier@iro.umontreal.ca>
To: "Eric M. Ludlam" <eric@siege-engine.com>
Cc: Kevin Ryde <user42@zip.com.au>, emacs-devel@gnu.org
Subject: Re: checkdoc-batch.el v.3
Date: Wed, 12 May 2010 22:40:00 -0400	[thread overview]
Message-ID: <jwvocgksf3g.fsf-monnier+emacs@gnu.org> (raw)
In-Reply-To: <4BEB5833.40805@siege-engine.com> (Eric M. Ludlam's message of "Wed, 12 May 2010 21:38:59 -0400")

>>> This spot of code runs M-x checkdoc in "batch" style, giving a report of
>>> problems instead of going through interactively fixing them.
>> This sounds desirable.
> If you pass a prefix argument to checkdoc-current-buffer, and a couple other
> functions, it logs all the messages to a buffer.

I know.  That's pretty much the only way I use checkdoc explicitly.
Note that it may still not list all problems (it seems that if there are
problems in the general file layout (e.g. missing trailer) it doesn't
move on to further things).

>> I generally like checkdoc, but it's too much in-your-face for my taste.
> I have found that once code is clean, checkdoc doesn't complain.  If it does
> I fix the code and it stops complaining.  If you work constantly in
> non-compliant code, this would indeed be a pain.

I want to turn it on unconditionally.  That means it should just be
a nag, but not a pain, if you don't care to follow its advice.
BTW, I often don't follow its advice, and other times I do but it
doesn't notice/understand it.

>> - solve the problem you mention that rejecting one suggestion can make
>> you miss subsequent ones.
> Using the log mode I mentioned above solves this.

I don't think it does completely.


        Stefan



  reply	other threads:[~2010-05-13  2:40 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <mailman.5.1273618593.5320.gnu-emacs-sources@gnu.org>
2010-05-12 15:10 ` checkdoc-batch.el v.3 Stefan Monnier
2010-05-13  1:38   ` Eric M. Ludlam
2010-05-13  2:40     ` Stefan Monnier [this message]
2010-05-14 23:15       ` Kevin Ryde

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=jwvocgksf3g.fsf-monnier+emacs@gnu.org \
    --to=monnier@iro.umontreal.ca \
    --cc=emacs-devel@gnu.org \
    --cc=eric@siege-engine.com \
    --cc=user42@zip.com.au \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.