GNU bug report logs - #41026
Improve documentation of `makunbound' and `fmakunbound'

Previous Next

Full log

Message #49 received at 41026 <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Andreas Schwab <schwab <at> linux-m68k.org>
Cc: 41026 <at> debbugs.gnu.org, stefan <at> marxist.se
Subject: Re: bug#41026: Improve documentation of `makunbound' and `fmakunbound'
Date: Sun, 03 May 2020 23:06:39 -0400

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > Why do these unimportant functions that almost nobody needs require such
  > elaborate doc strings?

So that those people who may want to use them, even if they are few,
can be sure of how to use them.

The cost of writing full and clear doc strings is some work, but once
that work is done, it costs nothing to have them in the source files.

-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.