[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: Towards a cleaner build

From: Drew Adams
Subject: RE: Towards a cleaner build
Date: Thu, 16 May 2019 20:24:45 -0700 (PDT)

> In Info-edit:
> info.el:4415:4:Warning: ‘Info-edit-mode’ is an obsolete function (as of 24.4);
>     editing Info nodes by hand is not recommended.
> which is
> (make-obsolete 'Info-edit-mode
>              "editing Info nodes by hand is not recommended." "24.4")
> (defun Info-edit ()
>   "Edit the contents of this Info node."
>   (interactive)
>   (Info-edit-mode)
>   (message "%s" (substitute-command-keys
>                "Editing: Type \\<Info-edit-mode-map>\\[Info-cease-edit] to
> return to info")))
> (put 'Info-edit 'disabled "Editing Info nodes by hand is not recommended.
> This feature will be removed in future.")
> (make-obsolete 'Info-edit
>              "editing Info nodes by hand is not recommended." "24.4")
> etc etc etc.  All the Info-edit stuff was declared obsolete in 24.4, and
> I seem to recall that our policy for removing obsolete stuff is two
> release cycles?  (I couldn't find anything in admin/notes that said
> anything about this explicitly...)  So it OK to remove all the Info-edit
> modes and commands now?

FWIW, I don't think we should have declared it "obsolete".
It's OK to recommend not editing nodes, but I don't see
why we would remove the possibility.  It's a quick-and-easy
(or quick-and-dirty, if you prefer) way for a user to add
her own notes or clarifications to the existing doc.  So
what if it's temporary, hackish, not texinfo etc.?  Has its
existence ever hurt anyone?  Is it a pain to "maintain"?

Yes, I said this at the time.  Just one opinion.  Does no
harm, can be somewhat useful.  Just remove the runtime
warning and leave it disabled by default: voila - "cleaner

reply via email to

[Prev in Thread] Current Thread [Next in Thread]