[U-Boot] [PATCH] Add feature-removal-schedule.txt

[U-Boot] [PATCH] Add feature-removal-schedule.txt

[Peter Tyser]

Add a text file which lists features to be removed from U-Boot
in the future.

The initial entry plans for removal of individual I2C commands.

Signed-off-by: Peter Tyser <ptyser@xes-inc.com>
---
 I wasn't sure what to make of the 'Deprecate "autosrc" command' on
 http://www.denx.de/wiki/U-Boot/TaskFeatureRemovalSchedule - I'm
 not familiar with it and didn't see any references to it in the
 current U-Boot tree.

 doc/feature-removal-schedule.txt |   17 +++++++++++++++++
 1 files changed, 17 insertions(+), 0 deletions(-)
 create mode 100644 doc/feature-removal-schedule.txt

diff --git a/doc/feature-removal-schedule.txt b/doc/feature-removal-schedule.txt
new file mode 100644
index 0000000..0c44f8a
--- /dev/null
+++ b/doc/feature-removal-schedule.txt
@@ -0,0 +1,17 @@
+The following is a list of files and features that are going to be
+removed from the U-Boot source tree.  Every entry should contain what
+exactly is going away, why it is happening, and who is going to be doing
+the work.  When the feature is removed from U-Boot, it should also
+be removed from this file.
+
+---------------------------
+
+What:	Individual I2C commands
+When:	April 2009
+Why:	Per the U-Boot README, individual I2C commands such as "imd", "imm",
+	"imw", etc are deprecated. The single "i2c" command which is
+	currently enabled via CONFIG_I2C_CMD_TREE contains the same
+	functionality as the individual I2C commands. The individual
+	I2C commands should be removed as well as any references to
+	CONFIG_I2C_CMD_TREE.
+Who:	Peter Tyser <ptyser@xes-inc.com>
-- 
1.6.0.2.GIT

[U-Boot] [PATCH] Add feature-removal-schedule.txt

[Peter Tyser]

Signed-off-by: Peter Tyser <ptyser@xes-inc.com>
---
See the following threads for background:
http://article.gmane.org/gmane.comp.boot-loaders.u-boot/48429
http://article.gmane.org/gmane.comp.boot-loaders.u-boot/47755
http://article.gmane.org/gmane.comp.boot-loaders.u-boot/53340

 doc/feature-removal-schedule.txt |   37 +++++++++++++++++++++++++++++++++++++
 1 files changed, 37 insertions(+), 0 deletions(-)
 create mode 100644 doc/feature-removal-schedule.txt

diff --git a/doc/feature-removal-schedule.txt b/doc/feature-removal-schedule.txt
new file mode 100644
index 0000000..901dc46
--- /dev/null
+++ b/doc/feature-removal-schedule.txt
@@ -0,0 +1,37 @@
+The following is a list of files and features that are going to be
+removed from the U-Boot source tree.  Every entry should contain what
+exactly is going away, when it will be gone, why it is being removed,
+and who is going to be doing the work.  When the feature is removed
+from U-Boot, its corresponding entry should also be removed from this
+file.
+
+---------------------------
+
+What:	"autoscr" command
+When:	August 2009
+Why:	"autosrc" is an ugly and completely non-standard name.  The "autoscr"
+	command is deprecated and will be replaced the "source" command as
+	used by other shells such as bash.  Both commands will be supported
+	for a transition period of 6 months after which "autoscr" will be
+	removed.
+Who:	Peter Tyser <ptyser@xes-inc.com>
+
+---------------------------
+
+What:	Individual I2C commands
+When:	April 2009
+Why:	Per the U-Boot README, individual I2C commands such as "imd", "imm",
+	"imw", etc are deprecated.  The single "i2c" command which is
+	currently enabled via CONFIG_I2C_CMD_TREE contains the same
+	functionality as the individual I2C commands.  The individual
+	I2C commands should be removed as well as any references to
+	CONFIG_I2C_CMD_TREE.
+Who:	Peter Tyser <ptyser@xes-inc.com>
+
+---------------------------
+
+What:	Legacy NAND code
+When:	April 2009
+Why:	Legacy NAND code is deprecated.  Similar functionality exists in
+	more recent NAND code ported from the Linux kernel.
+Who:	Scott Wood <scottwood@freescale.com>
-- 
1.6.0.2.GIT

[U-Boot] [PATCH] Add feature-removal-schedule.txt

[Wolfgang Denk]

Dear Peter Tyser,

In message <1233355000-18632-1-git-send-email-ptyser@xes-inc.com> you wrote:
> Signed-off-by: Peter Tyser <ptyser@xes-inc.com>
> ---
> See the following threads for background:
> http://article.gmane.org/gmane.comp.boot-loaders.u-boot/48429
> http://article.gmane.org/gmane.comp.boot-loaders.u-boot/47755
> http://article.gmane.org/gmane.comp.boot-loaders.u-boot/53340
> 
>  doc/feature-removal-schedule.txt |   37 +++++++++++++++++++++++++++++++++++++
>  1 files changed, 37 insertions(+), 0 deletions(-)
>  create mode 100644 doc/feature-removal-schedule.txt

Applied, thanks.

Best regards,

Wolfgang Denk

-- 
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
Mistakes are often the stepping stones to utter failure.

[U-Boot] [PATCH] Add feature-removal-schedule.txt

[Peter Tyser]

> +What:	Individual I2C commands
> +When:	April 2009
> +Why:	Per the U-Boot README, individual I2C commands such as "imd", "imm",
> +	"imw", etc are deprecated.  The single "i2c" command which is
> +	currently enabled via CONFIG_I2C_CMD_TREE contains the same
> +	functionality as the individual I2C commands.  The individual
> +	I2C commands should be removed as well as any references to
> +	CONFIG_I2C_CMD_TREE.
> +Who:	Peter Tyser <ptyser@xes-inc.com>

Would people prefer there be a period of time where both the individual
i2c commands as well the single "i2c" command are both supported for
boards without CONFIG_I2C_CMD_TREE?  If so, I'd add some deprecation
messages to the individual commands.

Its a little PITA to add a "DEPRECATED" message to all the "old style"
commands as they are also called by the newer "i2c" command, so just
wanted to check before submitting a patch.

Thanks,
Peter

[U-Boot] [PATCH] Add feature-removal-schedule.txt

[Detlev Zundel]

Hi Peter,

>> +What:	Individual I2C commands
>> +When:	April 2009
>> +Why:	Per the U-Boot README, individual I2C commands such as "imd", "imm",
>> +	"imw", etc are deprecated.  The single "i2c" command which is
>> +	currently enabled via CONFIG_I2C_CMD_TREE contains the same
>> +	functionality as the individual I2C commands.  The individual
>> +	I2C commands should be removed as well as any references to
>> +	CONFIG_I2C_CMD_TREE.
>> +Who:	Peter Tyser <ptyser@xes-inc.com>
>
> Would people prefer there be a period of time where both the individual
> i2c commands as well the single "i2c" command are both supported for
> boards without CONFIG_I2C_CMD_TREE?  If so, I'd add some deprecation
> messages to the individual commands.
>
> Its a little PITA to add a "DEPRECATED" message to all the "old style"
> commands as they are also called by the newer "i2c" command, so just
> wanted to check before submitting a patch.

I vote for doing the transition in one step.  It's simply not worth too
much effort in my eyes.  We have other areas needing more attention ;)

Cheers
  Detlev

-- 
BUGS:
  It is not yet possible to change operating system by writing to
  /proc/sys/kernel/ostype.
                                     -- Linux sysctl(2) man page
--
DENX Software Engineering GmbH,      MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich,  Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-40 Fax: (+49)-8142-66989-80 Email: dzu at denx.de