Add ENVIRONMENT and NOTES to manpage

Add references to new sections.
main
postscript-dev 4 years ago
parent 51c8d698b2
commit 5e53fd83c2
No known key found for this signature in database
GPG Key ID: F3EC02A099292862

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH EXIV2 1 "August 09, 2021"
.TH EXIV2 1 "August 26, 2021"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -106,7 +106,7 @@ Delete image metadata from the files.
.B ad | adjust
Adjust Exif timestamps by the given time. Requires at least one of the
options \fB\--adjust\fP \fItime\fP, \fB\--years\fP \fI+-n\fP, \fB\--months\fP
\fI+-n\fP or \fB\--days\fP \fI+-n\fP.
\fI+-n\fP or \fB\--days\fP \fI+-n\fP. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B mo | modify
Apply commands to modify (add, set, delete) the Exif, IPTC and XMP
@ -118,7 +118,7 @@ Rename files and/or set file timestamps according to the Exif create
timestamp. Uses the value of tag Exif.Photo.DateTimeOriginal or, if
not present, Exif.Image.DateTime to determine the timestamp. The
filename format can be set with \fB\--rename\fP \fIfmt\fP, timestamp options
are \fB\--timestamp\fP and \fB\--Timestamp\fP.
are \fB\--timestamp\fP and \fB\--Timestamp\fP. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B fi | fixiso
Copy the ISO setting from one of the proprietary Nikon or Canon
@ -312,13 +312,12 @@ options.
.B \-t, --timestamp
Set the file timestamp according to the Exif create timestamp in
addition to renaming the file (overrides \fB\--keep\fP). This option is
only used with the 'rename' action.
only used with the 'rename' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B \-T, --Timestamp
Only set the file timestamp according to the Exif create timestamp, do
not rename the file (overrides \fB\--keep\fP). This option is only used
with the 'rename' action. Note: On Windows you may have to set the TZ
environment variable for this option to work correctly.
with the 'rename' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B \-f, --force or \-F, --Force
These options are used by the 'rename' and 'extract' actions to
@ -351,10 +350,11 @@ has already been renamed:
.br
.TP
.B \-r \fIfmt\fP, --rename \fIfmt\fP
Filename format for the 'rename' action. The \fIfmt\fP string follows
the definitions in \fBstrftime\fP(3), using Exif.Photo.DateTimeOriginal
or Exif.Image.DateTime as the reference date and time.
In addition, the following special character sequences are also provided:
Filename format for the 'rename' action (See \fBTZ\fP in \fBENVIRONMENT\fP).
The \fIfmt\fP string follows the definitions in \fBstrftime\fP(3), using
Exif.Photo.DateTimeOriginal or Exif.Image.DateTime as the reference date
and time. In addition, the following special character sequences are also
provided:
.TS
l l l.
:basename: Original filename without extension
@ -395,7 +395,7 @@ For example, when renaming a second Stonehenge.jpg file:
.TP
.B \-a \fItime\fP, \--adjust \fItime\fP
Time adjustment, where \fItime\fP is in the format [\-]HH[:MM[:SS]]. This option is only
used with the 'adjust' action.
used with the 'adjust' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.sp 1
Examples of \fItime\fP are:
@ -409,15 +409,15 @@ l l.
.TP
.B \-Y \fI+-n\fP, --years \fI+-n\fP
Time adjustment by a positive or negative number of years, for
the 'adjust' action.
the 'adjust' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B \-O \fI+-n\fP, --months \fI+-n\fP
Time adjustment by a positive or negative number of months, for
the 'adjust' action.
the 'adjust' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B \-D \fI+-n\fP, \--days \fI+-n\fP
Time adjustment by a positive or negative number of days, for
the 'adjust' action.
the 'adjust' action. See \fBTZ\fP in \fBENVIRONMENT\fP.
.TP
.B \-p \fImode\fP, --print \fImode\fP,
Print mode for the 'print' action (see \fBDESCRIPTION\fP, for metadata support in a file type). Possible modes are:
@ -1137,7 +1137,18 @@ sense in the target image.
Adds the Exif ISO metadata (if missing) to \fIimage.jpg\fP. This is for
Nikon and Canon cameras only and copies the camera maker's value into the Exif
metadata.
.sp 1
.SH ENVIRONMENT
.TP
\fBTZ\fP
This is the timezone to use when adjusting for daylight savings time (DST) and
affects the changing of the the time and date (e.g., when adjusting or
renaming). See \fIhttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones\fP
for a list of valid values to use. The variable is not set by default for
Windows and an attempt is made to obtain the timezone from the OS. If this
fails, the DST rules for the United States are used. This can be corrected
by defining \fBTZ\fP.
.SH NOTES
For further help, see the Exiv2 wiki: \fIhttps://github.com/Exiv2/exiv2/wiki\fP
.SH BUGS
Report bugs to: \fIhttps://github.com/Exiv2/exiv2/issues\fP
.SH COPYRIGHT
@ -1156,6 +1167,7 @@ Exiv2 wiki: \fIhttps://github.com/Exiv2/exiv2/wiki\fP
APEX Exposure values: \fIhttps://en.wikipedia.org/wiki/APEX_system\fP
International Language Codes: \fIhttps://www.ietf.org/rfc/rfc3066.txt\fP
Windows INI format: \fIhttps://en.wikipedia.org/wiki/INI_file\fP
TZ Environment variable values: \fIhttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones\fP
.fi
.SH AUTHORS

Loading…
Cancel
Save