subversion-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Julian Foad (Jira)" <j...@apache.org>
Subject [jira] [Resolved] (SVN-4828) svn help: hide experimental, deprecated, and global commands and options
Date Mon, 02 Sep 2019 15:01:00 GMT

     [ https://issues.apache.org/jira/browse/SVN-4828?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Julian Foad resolved SVN-4828.
------------------------------
    Resolution: Fixed

Closing as "fixed".

Hiding deprecated options is not done; moving that to a separate, lower priority enhancement,
issue SVN-4829.

> svn help: hide experimental, deprecated, and global commands and options
> ------------------------------------------------------------------------
>
>                 Key: SVN-4828
>                 URL: https://issues.apache.org/jira/browse/SVN-4828
>             Project: Subversion
>          Issue Type: Improvement
>          Components: cmdline client
>    Affects Versions: trunk
>            Reporter: Julian Foad
>            Assignee: Julian Foad
>            Priority: Major
>
> Hide experimental features, by default:
>  - let 'svn help' omit experimental commands and options
>  - let 'svn help -v' include them
> The idea is that users wanting a stable experience should not be distracted by experimental
features unless they choose to see them.
> Further, I have been thinking for years we should hide by default:
> - deprecated commands and options
>  - the "Global Options" section of "svn help <subcommand>"
> The global options are sometimes useful, but really only for power users; take up the
last half a screenful of output; are shown even for commands where they are irrelevant (all
commands accept them but not all use them).
> There are only a few deprecated options, so not such a big distraction, but users don't
need to see or learn or care about them at all, except in the most extreme cases like debugging
an old script that uses them.
> I plan to hide these three categories by default.



--
This message was sent by Atlassian Jira
(v8.3.2#803003)

Mime
View raw message