'\" t
.\"     Title: L
.\"    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 "L" "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"
l \- Displays a verbose description about the specified list of objects\&.
.SH "SYNOPSIS"
.HP \w'\fBl\fR\ 'u
\fBl\fR [\-t] [\-v] [\-r] {\fIobjects\fR}
.SH "DESCRIPTION"
.PP
Displays a verbose description about the specified list of objects\&. If a specified
\fIobject\fR
is a path, then any transformation matrices along that
\fIpath\fR
are applied\&. If the final
\fIpath\fR
component is a combination, the command will list the Boolean formula for the
\fIcombination\fR
and will indicate any accumulated transformations (including any in that
\fIcombination\fR)\&. If a shader and/or color has been assigned to the
\fIcombination\fR, the details will be listed\&. For a region, its ident, air code, material code, and LOS will also be listed\&. For primitive shapes, detailed
\fIshape\fR
parameters will be displayed with the accumulated transformation applied\&.
.SH "OPTIONS"
.PP
\fB\-t\fR
.RS 4
The
\fI\-t\fR
(terse) option forces a shorter list of primitive shape parameters\&. This option is default for primitives with potentially long parameter lists, such as BoTs\&.
.RE
.PP
\fB\-v\fR
.RS 4
The
\fI\-v\fR
(verbose) option gives all data for explicit shapes (BoT, BREP, datum, NMG, pnts, sketch) which are terse by default\&.
.RE
.PP
\fB\-r\fR
.RS 4
If the
\fI\-r\fR
(recursive) option is used, then each
\fIobject\fR
on the command line will be treated as a
\fIpath\fR\&. If the
\fIpath\fR
does not end at a primitive
\fIshape\fR, then all possible
\fIpaths\fR
from that point down to individual
\fIshapes\fR
will be considered\&. The
\fIshape\fR
at the end of each possible
\fIpath\fR
will be listed with its parameters adjusted by the accumulated transformation\&.
.RE
.SH "EXAMPLES"
.PP
The three examples show the use of the
\fBl\fR
command to display details about a region, shape parameters, and all possible paths starting with a particular designation\&.
.PP
\fBExample\ \&1.\ \&Display details about a particular region.\fR
.PP
mged> \fBl region1\fR
.RS 4
Displays details about region1\&.
.RE
.PP
\fBExample\ \&2.\ \&Display shape parameters for a particular shape.\fR
.PP

mged>\fBl group1/group2/region1/shape3\fR
.PP
Displays shape parameters for
\fIshape3\fR
with matrices applied from the
\fIpath\fR\&.
.PP
\fBExample\ \&3.\ \&Display all paths that start with a particular designation and end in a primitive shape.\fR
.PP

mged>\fBl \-r a/b\fR
.PP
Displays all paths that start with a particular designation and end in a primitive shape\&. Also, the shape parameters with the accumulated transformation applied will be displayed\&.
.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
