Patchwork [v2] help: add new deprecated topic

login
register
mail settings
Submitter David Demelier
Date May 15, 2018, 7:01 a.m.
Message ID <317945f68d32a6f0a601.1526367691@x1>
Download mbox | patch
Permalink /patch/31592/
State Accepted
Headers show

Comments

David Demelier - May 15, 2018, 7:01 a.m.
# HG changeset patch
# User David Demelier <markand@malikania.fr>
# Date 1526296264 -7200
#      Mon May 14 13:11:04 2018 +0200
# Node ID 317945f68d32a6f0a601bbc6a74cf006871601f8
# Parent  8ba0344f9fb145f5b9b909f1211defc9e0793f68
help: add new deprecated topic

Add a deprecated topic which lists most of the commands and options that are not
recommended anymore.
Yuya Nishihara - May 15, 2018, 11:49 a.m.
On Tue, 15 May 2018 09:01:31 +0200, David Demelier wrote:
> # HG changeset patch
> # User David Demelier <markand@malikania.fr>
> # Date 1526296264 -7200
> #      Mon May 14 13:11:04 2018 +0200
> # Node ID 317945f68d32a6f0a601bbc6a74cf006871601f8
> # Parent  8ba0344f9fb145f5b9b909f1211defc9e0793f68
> help: add new deprecated topic

Queued, thanks.

> @@ -232,6 +232,7 @@
>      (['bundlespec'], _("Bundle File Formats"), loaddoc('bundlespec')),
>      (['color'], _("Colorizing Outputs"), loaddoc('color')),
>      (["config", "hgrc"], _("Configuration Files"), loaddoc('config')),
> +    (['deprecated'], _("Deprecated features"), loaddoc('deprecated')),

Title-Caps looks more common here, fixed in flight.

Patch

diff -r 8ba0344f9fb1 -r 317945f68d32 contrib/wix/help.wxs
--- a/contrib/wix/help.wxs	Fri May 11 22:07:43 2018 -0400
+++ b/contrib/wix/help.wxs	Mon May 14 13:11:04 2018 +0200
@@ -19,6 +19,7 @@ 
           <File Name="color.txt" />
           <File Name="config.txt" KeyPath="yes" />
           <File Name="dates.txt" />
+          <File Name="deprecated.txt" />
           <File Name="diffs.txt" />
           <File Name="environment.txt" />
           <File Name="extensions.txt" />
diff -r 8ba0344f9fb1 -r 317945f68d32 mercurial/help.py
--- a/mercurial/help.py	Fri May 11 22:07:43 2018 -0400
+++ b/mercurial/help.py	Mon May 14 13:11:04 2018 +0200
@@ -232,6 +232,7 @@ 
     (['bundlespec'], _("Bundle File Formats"), loaddoc('bundlespec')),
     (['color'], _("Colorizing Outputs"), loaddoc('color')),
     (["config", "hgrc"], _("Configuration Files"), loaddoc('config')),
+    (['deprecated'], _("Deprecated features"), loaddoc('deprecated')),
     (["dates"], _("Date Formats"), loaddoc('dates')),
     (["flags"], _("Command-line flags"), loaddoc('flags')),
     (["patterns"], _("File Name Patterns"), loaddoc('patterns')),
diff -r 8ba0344f9fb1 -r 317945f68d32 mercurial/help/deprecated.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mercurial/help/deprecated.txt	Mon May 14 13:11:04 2018 +0200
@@ -0,0 +1,30 @@ 
+Mercurial evolves over time, some features, options, commands may be replaced by
+better and more secure alternatives. This topic will help you migrating your
+existing usage and/or configuration to newer features.
+
+Commands
+========
+
+The following commands are still available but their use are not recommended:
+
+``locate``
+
+This command has been replaced by `hg files`.
+
+``parents``
+
+This command can be replaced by `hg summary` or `hg log` with appropriate
+revsets. See `hg help revsets` for more information.
+
+``tip``
+
+The recommended alternative is `hg heads`.
+
+Options
+=======
+
+``web.allowpull``
+    Renamed to `allow-pull`.
+
+``web.allow_push``
+    Renamed to `allow-push`.