[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
build."
- Re: Towards a cleaner build, (continued)
- Re: Towards a cleaner build, Stefan Monnier, 2019/05/28
- Re: Towards a cleaner build, Stefan Monnier, 2019/05/17
- Re: Towards a cleaner build, Lars Ingebrigtsen, 2019/05/18
- Re: Towards a cleaner build, Stefan Monnier, 2019/05/18
- Re: Towards a cleaner build, Lars Ingebrigtsen, 2019/05/18
- Re: Towards a cleaner build, Eli Zaretskii, 2019/05/17
- Re: Towards a cleaner build, Stefan Monnier, 2019/05/17
RE: Towards a cleaner build,
Drew Adams <=
Re: Towards a cleaner build, Lars Ingebrigtsen, 2019/05/16
Re: Towards a cleaner build, Lars Ingebrigtsen, 2019/05/16
Re: Towards a cleaner build, Eli Zaretskii, 2019/05/17