'\" t
.\"     Title: LC
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "LC" "nged" "08/28/2023" "BRL\-CAD" "BRL\-CAD User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
lc \- Lists codes (i\&.e\&. region attributes) \*(Aqregion_id\*(Aq, \*(Aqmaterial_id\*(Aq, \*(Aqlos\*(Aq, \*(Aqaircode\*(Aq, \*(Aqregion name\*(Aq, \*(Aqregion parent\*(Aq within a group or combination\&.
.SH "SYNOPSIS"
.HP \w'\fBlc\fR\ 'u
\fBlc\fR [\-d | \-m | \-s] [\-r] [\-z] [\-0 | \-1 | \-2 | \-3 | \-4 | \-5 | \-6] [\-f {\fIFileName\fR}] {\fIGroupName\fR}
.SH "DESCRIPTION"
.PP
The \*(Aqlc\*(Aq command lists a set of codes (i\&.e\&. attributes) of regions within a group/combination\&. Listed in columns are the following: \*(Aqregion_id\*(Aq, \*(Aqmaterial_id\*(Aq, \*(Aqlos\*(Aq, \*(Aqaircode\*(Aq, \*(Aqregion name\*(Aq, \*(Aqregion parent\*(Aq\&. If a value is unset, it is reported as \*(Aq\-\-\*(Aq\&.
.SH "OPTIONS"
.PP
\fB\-d\fR
.RS 4
Specifies to list only one region with each \*(Aqregion_id\*(Aq\&.
.RE
.PP
\fB\-m\fR
.RS 4
Specifies to list only regions with shared \*(Aqregion_id\*(Aq values where one or more of the objects in the set of objects defined by shared \*(Aqregion_id\*(Aq value reports a different \*(Aqmaterial_id\*(Aq, \*(Aqaircode\*(Aq and/or \*(Aqlos\*(Aq values\&. Essentially, this allows users to quickly find and resolve inconsistent codes (i\&.e, id settings) within a \*(Aqregion_id\*(Aq group\&.
.RE
.PP
\fB\-s\fR
.RS 4
Specifies to list only one region with each combination of \*(Aqregion_id\*(Aq, \*(Aqmaterial_id\*(Aq, \*(Aqlos\*(Aq, and \*(Aqaircode\*(Aq\&. In addition to the output of \*(Aq\-d\*(Aq, it lists those cases where \*(Aqregion_id\*(Aq is the same but \*(Aqmaterial_id\*(Aq and/or \*(Aqlos\*(Aq and/or \*(Aqaircode\*(Aq are different\&.
.RE
.PP
\fB\-r\fR
.RS 4
Remove regions from the list in which their parent is a region and the region is subtracted within the parent\&. The \*(Aq\-r\*(Aq option can be combined with any other option\&.
.RE
.PP
\fB\-z\fR
.RS 4
Specifies descending (z\-a) sort order\&.
.RE
.PP
\fB\-0\fR, \fB\-1\fR, \fB\-2\fR, \fB\-3\fR, \fB\-4\fR, \fB\-5\fR, \fB\-6\fR
.RS 4
Specifies sort column 1, 2, 3, 4, 5, or 6 (referring to columns listed in the description of this command); 1 is default\&. If 0 is specified, the regions are listed in the order in which they are stored, but this will be overridden if
\fB\-d\fR,
\fB\-m\fR, or
\fB\-s\fR
options are used, because of the sorting which needs to be done when either of those options is used\&.
.RE
.PP
\fB\-f FileName\fR
.RS 4
Identifies output should be to a file and specifies the file name\&. If the path is not included as part of the \*(AqFileName\*(Aq the path will be the \*(Aqcurrent directory\*(Aq\&.
.RE
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
