* avrdude.1, doc/avrdude.texi, doc/TODO: Removed the deprecated options from documentation

git-svn-id: svn://svn.savannah.nongnu.org/avrdude/trunk@411 81a1dc3b-b13d-400b-aceb-764788c761c2
This commit is contained in:
Jan-Hinnerk Reichert 2004-02-10 00:20:51 +00:00
parent 637626e9d6
commit f1ed5e5813
4 changed files with 81 additions and 158 deletions

View File

@ -1,3 +1,8 @@
2004-02-10 Jan-Hinnerk Reichert <hinni@despammed.com>
* avrdude.1, doc/avrdude.texi, doc/TODO:
Removed the deprecated options from documentation
2004-02-10 Jan-Hinnerk Reichert <hinni@despammed.com> 2004-02-10 Jan-Hinnerk Reichert <hinni@despammed.com>
* main.c: Removed deprecated options. * main.c: Removed deprecated options.

View File

@ -35,11 +35,7 @@
.Oo Fl E Ar exitspec Ns .Oo Fl E Ar exitspec Ns
.Op \&, Ns Ar exitspec .Op \&, Ns Ar exitspec
.Oc .Oc
.Op Fl f Ar format
.Op Fl F .Op Fl F
.Op Fl i Ar filename
.Op Fl m Ar memtype
.Op Fl o Ar filename
.Op Fl n .Op Fl n
.Op Fl P Ar port .Op Fl P Ar port
.Op Fl q .Op Fl q
@ -189,11 +185,6 @@ option with flash memory is specified,
will perform a chip erase before starting any of the programming will perform a chip erase before starting any of the programming
operations, since it generally is a mistake to program the flash operations, since it generally is a mistake to program the flash
without performing an erase first. This option disables that. without performing an erase first. This option disables that.
However, to remain backward compatible, the
.Fl i ,
and
.Fl m
options automatically disable the auto erase feature.
.It Fl e .It Fl e
Causes a chip erase to be executed. This will reset the contents of the Causes a chip erase to be executed. This will reset the contents of the
flash ROM and EEPROM to the value flash ROM and EEPROM to the value
@ -257,32 +248,6 @@ pins of the parallel port down at program exit.
Multiple Multiple
.Ar exitspec .Ar exitspec
arguments can be separated with commas. arguments can be separated with commas.
.It Fl f Ar format
(Deprecated, use
.Fl U
instead.) This option specifies the file format for the input or
output files to be processed.
.Ar Format
can be one of:
.Bl -tag -width sss
.It Ar i
Intel Hex
.It Ar s
Motorola S-record
.It Ar r
raw binary; little-endian byte order, in the case of the flash ROM data
.It Ar m
immediate; actual byte values specified on the command line, seperated
by commas or spaces. This is good for programming fuse bytes without
having to create a single-byte file or enter terminal mode.
.It Ar a
auto detect; valid for input only, and only if the input is not
provided at
.Em stdin .
.El
.Pp
The default is to use auto detection for input files, and raw binary
format for output files.
.It Fl F .It Fl F
Normally, Normally,
.Nm .Nm
@ -291,55 +256,10 @@ reasonable before continuing. Since it can happen from time to time
that a device has a broken (erased or overwritten) device signature that a device has a broken (erased or overwritten) device signature
but is otherwise operating normally, this options is provided to but is otherwise operating normally, this options is provided to
override the check. override the check.
.It Fl i Ar filename
(Deprecated, use
.Fl U
instead.) Specifies the input file to be programmed into the MCU.
Can be specified as
.Ql \&-
to use
.Em stdin
as the input.
.It Fl I Ar data
(Deprecated, use
.Fl U
instead.) Same as specifying
.Fl i
and
.Fl f Ar m
together, i.e., this is a shortcut for using immediate file input mode
where the filename field is used as the data itself. Useful for
programming single byte memories such as fuse bytes without having to
use single byte files or enter interactive terminal mode.
.It Fl m Ar memtype
(Deprecated, use
.Fl U
instead.) Specifies which program area of the MCU to read or write;
allowable values depend on the MCU being programmed, but most support
at least
.Em eeprom
for the EEPROM, and
.Em flash
for the flash ROM. Use the
.Fl v
option on the command line or the
.Ar part
command from terminal mode to display all the memory types supported
by a particular device. The default is
.Em flash .
.It Fl n .It Fl n
No-write - disables actually writing data to the MCU (useful for debugging No-write - disables actually writing data to the MCU (useful for debugging
.Nm avrdude .Nm avrdude
). ).
.It Fl o Ar filename
(Deprecated, use
.Fl U
instead.) Specifies the name of the output file to write, and causes
the respective memory area to be read from the MCU. Can be specified
as
.Ql \&-
to write to
.Em stdout .
.It Fl P Ar port .It Fl P Ar port
Use Use
.Ar port .Ar port
@ -384,9 +304,28 @@ field indicates the name of the file to read or write.
The The
.Ar format .Ar format
field is optional and contains the format of the file to read or field is optional and contains the format of the file to read or
write. See the write.
.Fl f .Ar Format
option for possible values. can be one of:
.Bl -tag -width sss
.It Ar i
Intel Hex
.It Ar s
Motorola S-record
.It Ar r
raw binary; little-endian byte order, in the case of the flash ROM data
.It Ar m
immediate; actual byte values specified on the command line, seperated
by commas or spaces. This is good for programming fuse bytes without
having to create a single-byte file or enter terminal mode.
.It Ar a
auto detect; valid for input only, and only if the input is not
provided at
.Em stdin .
.El
.Pp
The default is to use auto detection for input files, and raw binary
format for output files.
Note that if Note that if
.Ar filename .Ar filename
contains a colon, the contains a colon, the

View File

@ -4,8 +4,6 @@
- Website needs to link to docs: - Website needs to link to docs:
http://savannah.nongnu.org/download/avrdude/doc/avrdude-html/ http://savannah.nongnu.org/download/avrdude/doc/avrdude-html/
- Remove old options from manpage and texinfo-documentation
- [Windows Port] Use Windows API for serial port communications (ser_win32.c). - [Windows Port] Use Windows API for serial port communications (ser_win32.c).
(In Progress) (In Progress)

View File

@ -420,10 +420,60 @@ program exit.
Multiple @var{exitspec} arguments can be separated with commas. Multiple @var{exitspec} arguments can be separated with commas.
@item -F
Normally, AVRDUDE tries to verify that the device signature read from
the part is reasonable before continuing. Since it can happen from time
to time that a device has a broken (erased or overwritten) device
signature but is otherwise operating normally, this options is provided
to override the check.
@item -f @var{format} @item -n
This option specifies the file format for the input or output files to No-write - disables actually writing data to the MCU (useful for
be processed. Format can be one of: debugging AVRDUDE).
@item -P @var{port}
Use port to identify the device to which the programmer is attached.
Normally, the default parallel port is used, but if the programmer type
normally connects to the serial port, the default serial port will be
used. See Appendix A, Platform Dependent Information, to find out the
default port names for your platform. If you need to use a different
parallel or serial port, use this option to specify the alternate port name.
@item -q
Disable (or quell) output of the progress bar while reading or writing
to the device.
@item -t
Tells AVRDUDE to enter the interactive ``terminal'' mode instead of up-
or downloading files. See below for a detailed description of the
terminal mode.
@item -U @var{memtype}:@var{op}:@var{filename}[:@var{format}]
Perform a memory operation, equivalent to specifing the @option{-m},
@option{-i} or @option{-o}, and @option{-f} options, except that
multiple @option{-U} optins can be specified in order to operate on
mulitple memories on the same command-line invocation. The
@var{memtype} field specifies the memory type to operate on. Use
the @option{-v} option on the command line or the @code{part} command from
terminal mode to display all the memory types supported by a particular
device.
The @var{op} field specifies what operation to perform:
@table @code
@itemx r
read the specified device memory and write to the specified file
@itemx w
read the specified file and write it to the specified device memory
@itemx v
read the specified device memory and the specified file and perform a verify operation
@end table
The @var{filename} field indicates the name of the file to read or
write. The @var{format} field is optional and contains the format of
the file to read or write. Possible values are:
@table @code @table @code
@itemx i @itemx i
@ -454,75 +504,6 @@ at stdin.
The default is to use auto detection for input files, and raw binary The default is to use auto detection for input files, and raw binary
format for output files. format for output files.
@item -F
Normally, AVRDUDE tries to verify that the device signature read from
the part is reasonable before continuing. Since it can happen from time
to time that a device has a broken (erased or overwritten) device
signature but is otherwise operating normally, this options is provided
to override the check.
@item -i @var{filename}
Specifies the input file to be programmed into the MCU. Can be
specified as `-' to use stdin as the input.
@item -m @var{memtype}
Specifies which program area of the MCU to read or write; allowable
values depend on the MCU being programmed, but most support at least
@code{eeprom} for the EEPROM, and @code{flash} for the flash ROM. Use
the @option{-v} option on the command line or the @code{part} command from
terminal mode to display all the memory types supported by a particular
device. The default is @code{flash}.
@item -n
No-write - disables actually writing data to the MCU (useful for
debugging AVRDUDE).
@item -o @var{filename}
Specifies the name of the output file to write, and causes the
respective memory area to be read from the MCU. Can be specified as `-'
to write to stdout.
@item -P @var{port}
Use port to identify the device to which the programmer is attached.
Normally, the default parallel port is used, but if the programmer type
normally connects to the serial port, the default serial port will be
used. See Appendix A, Platform Dependent Information, to find out the
default port names for your platform. If you need to use a different
parallel or serial port, use this option to specify the alternate port name.
@item -q
Disable (or quell) output of the progress bar while reading or writing
to the device.
@item -t
Tells AVRDUDE to enter the interactive ``terminal'' mode instead of up-
or downloading files. See below for a detailed description of the
terminal mode.
@item -U @var{memtype}:@var{op}:@var{filename}[:@var{format}]
Perform a memory operation, equivalent to specifing the @option{-m},
@option{-i} or @option{-o}, and @option{-f} options, except that
multiple @option{-U} optins can be specified in order to operate on
mulitple memories on the same command-line invocation. The
@var{memtype} field specifies the memory type to operate on. The
@var{op} field specifies what operation to perform:
@table @code
@itemx r
read the specified device memory and write to the specified file
@itemx w
read the specified file and write it to the specified device memory
@itemx v
read the specified device memory and the specified file and perform a verify operation
@end table
The @var{filename} field indicates the name of the file to read or
write. The @var{format} field is optional and contains the format of
the file to read or write. See the @option{-f} option for possible
values.
Note that if @var{filename} contains a colon, the @var{format} field is Note that if @var{filename} contains a colon, the @var{format} field is
no longer optional since the filename part following the colon would no longer optional since the filename part following the colon would
otherwise be misinterpreted as @var{format}. otherwise be misinterpreted as @var{format}.