--- ray/doc/man/man1/rcode_ident.1	2019/07/20 02:07:23	1.1
+++ ray/doc/man/man1/rcode_ident.1	2022/02/02 22:25:24	1.6
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rcode_ident.1,v 1.1 2019/07/20 02:07:23 greg Exp $"
+.\" RCSid "$Id: rcode_ident.1,v 1.6 2022/02/02 22:25:24 greg Exp $"
 .TH RCODE_IDENT 1 7/19/2019 RADIANCE
 .SH NAME
 rcode_ident - store identifiers in an indexed map and retrieve from same
@@ -28,15 +28,17 @@ input.txt
 ][
 .B \-H
 ][
+.B \-l
+][
+.B \-n
+][
 .B \-tS
 ]
-[
 input.idx
 [output.txt]
-]
 .SH DESCRIPTION
 .I Rcode_ident
-Takes a list of ASCII identifiers on the input and encodes them
+takes a list of ASCII identifiers on the input and encodes them
 as a 16-bit index to a table appended to the output.
 This default index size can hold up to 65 thousand unique IDs,
 which is suitable for most applications.
@@ -46,7 +48,7 @@ option may be used to specify an 8-bit index, which sa
 if 256 or fewer unique identifiers appear on the input.
 The
 .I \-24
-option creates a 24-bit index can record over 16 million
+option creates a 24-bit index that can record over 16 million
 unique identifiers.
 .PP
 Identifiers are separated by newlines by default, but any single-character
@@ -59,6 +61,9 @@ and the maximum ID length is 255 characters.
 .PP
 Input is taken from the first named file, or standard input if no
 files are given.
+(Input file is required for
+.I \-r
+option.)
 Output is sent to the second named file, or standard output if none.
 .PP
 The
@@ -89,6 +94,15 @@ string, respectively.
 The
 .I \-tS
 option specifies an alternate ID separator instead of the default newline.
+The
+.I \-l
+option tells
+.I rcode_ident
+to list identifiers following the header information (if present).
+The
+.I \-n
+option prints identifier table indexes rather than the strings themselves.
+Indexing starts from 0 for the first table entry.
 .PP
 When decoding, the
 .I \-i
@@ -113,7 +127,12 @@ rtrace -ffa < rays.flt -x 512 -y 400 -om octree | rcod
 To query specific modifiers using ximage with the 't' command:
 .IP "" .2i
 ximage -op render.hdr | rcode_ident -i -r mods.idx
+.PP
+To only print out the list of unique identifiers:
+.IP "" .2i
+rcode_ident -r -h -H -i -l mods.idx < /dev/null
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-rcalc(1), rcode_depth(1), rcode_norm(1), rlam(1), rsplit(1), rtpict(1)
+rcalc(1), rcode_depth(1), rcode_norm(1), rcode2bmp(1),
+rlam(1), rsplit(1), rtpict(1)