On Tue, Oct 17, 2017 at 10:45:15PM +0100, Thomas Gummerer wrote: > > Seems reasonable, though if we are deprecating "save" should we demote > > it from being in the synopsis entirely? > > I saw that as a next step, with the "official" deprecation of "save". > I thought we might want to advertise "push" a bit more before actually > officially deprecating "save" and sending the deprecation notice out > in the release notes.
Right, my thinking was that it would still be documented in the manpage, just lower down. And that would probably say something like "save is a historical synonym for push, except that it differs in these ways...". > OTOH, dropping it from the synopsis in the man page probably wouldn't > cause much issue, as "push" directly replaces it, and is easily > visible. Not sure how slow we want to take the deprecation? I don't think there's any reason to go slow in marking something as deprecated. It's the part where we follow up and remove or change the feature that must take a while. -Peff
