Re: doc string of make-char-internal

[Pavel Janík]

   From: Richard Stallman <address@hidden>
   Date: Wed, 24 Oct 2001 16:45:46 -0600 (MDT)

   >     Yes, but after some time, we will decide, that this string is not that 
we
   >     want. We will change all occurrences of it. Hmm. By using some other
   >     mechanism of "marking something for internal use" we can generalize it 
in
   >     one place (maybe we can do other thing when showing the doc-string for
   >     internal function in the future). This is good as I have learned in 
school.
   > 
   > I think that such design heuristics are worth paying attention to, but
   > shouldn't be followed rigidly.
   > 
   > So if you make a specific proposal, I will think about it.

I have thought about it for some time, and today I was enlightened ;-) Some
functions/variables in the sources have names internal-*. Almost all of
them are internal/for internal use only. Do you think we can say: "If the
function name begins with internal-, it is for internal use only."?
-- 
Pavel Janík

I was going to compile a list of innovations that could be attributed to
Microsoft. Once I realized that Ctrl-Alt-Del was handled in the BIOS,
I found that there aren't any.
                  -- Richard B. Johnson in linux-kernel