Etydhv

In enumitem manual, I can't find a clear explanation of the difference between the usage of exclamation mark and asterisk for leftmargin, itemindent, labelsep, labelwidth, and labelindent.

For example, what is the difference between setting labelsep=*

and labelsep=!?

documentclassarticle
usepackageenumitem

newcommandlitem[1]itembfseries#1.space

begindocument

beginenumerate[label=(alph*),labelsep=!]
 litemTerm one First term description.
 litemTerm two Second term description.
endenumerate

enddocument

As explained in the enumitem documentation, the horizontal spacing in lists is composed of the parameters leftmargin, itemindent, labelsep, labelwidth and labelindent as follows:

That is to say:

1. 
   

   The values obey the relation

   
   
   

   leftmargin = labelindent + labelwidth + labelsep - itemindent
   

   
   



2. The right edge of the item label will be indented by labelindent + labelwidth.



3. The first line of the Text of the item will be indented by leftmargin + itemindent.


4. Subsequent lines will be indented by leftmargin.

As you can see, there are five parameters but they are not all independent. Given any four of them you can calculate the fifth, which is where the ! and * values to these options come in.

Why have this redundancy at all? Well, in standard LaTeX, the parameter labelindent does not exist; it is introduced by enumitem. The author of the package felt that it might be useful to be able to directly set the indentation of the list label instead of having to calculate the other values manually in order to achieve the desired indentation.

By default, the new parameter labelindent is always calculated from the others. If you want to directly set labelindent, you will have to tell enumitem which parameter it should calculate instead. That is what the ! value is for.

* does exactly the same thing, but it also first sets labelwidth. This is useful because the right edge of the label is indented by 'labelindent + labelwidth', so the left edge of the label will only be indented by exactly labelindent, if the width of the label is actually labelwidth. enumitem tries to guess the width of the widest possible label by measuring the width of the label with value

• 
  0 if label is set using arabic*,


• 
  viii if label is set using roman*,


• 
  m if label is set using alph* and


• similarly for the uppercase versions.

So, if you set label=(alpha*), enumitem will measure the width of (m) and set labelwidth to this value. You can change this behavior using the widest option.

Note that this means that labelwidth=! and labelwidth=* do exactly the same thing.

Okay, so let's have a look at an example. enumitem acknowledges that the behavior of these values may be confusing and provides DrawEnumitemLabel to visualize the current values, which I will use below. It

[...] draws 4 rules from top to bottom, leftmargin (thin), labelindent (thick if positive, thin if negative), labelwidth (thick) and labelsep (thick if positive, thin if negative). If 0, a rule is not shown.

documentclassarticle

usepackageenumitem

parindent=0pt
newcommand*printvalue[1]textttstring #1 : the #1

begindocument

% set some defaults:
setlist
 label=(alph*),
 leftmargin=50pt,
 itemindent=10pt,
 labelsep=5pt,
 labelwidth=25pt,
 labelindent=10pt,
 

By default, my definition of verb|labelindent| is just ignored and it is calculated from the other values:
beginenumerate
 DrawEnumitemLabel
 item printvalueleftmargin
 item printvalueitemindent
 item printvaluelabelsep
 item printvaluelabelwidth
 item printvaluelabelindent
endenumerate

I can change that using the verb|!| value.
For example, I can instead calculate verb|labelsep| from the other values:
beginenumerate[labelindent=10pt, labelsep=!]
 DrawEnumitemLabel
 item printvalueleftmargin
 item printvalueitemindent
 item printvaluelabelsep
 item printvaluelabelwidth
 item printvaluelabelindent
endenumerate

The verb|*| value does exactly the same, only it also set the value of verb|labelwidth| first.
It tries to guess the widest possible label (textsl0 for verb|arabic*|, textslviii for verb|roman*|, textslm for verb|alph*|):
beginenumerate[labelindent=10pt, labelsep=*]
 DrawEnumitemLabel
 item printvalueleftmargin
 item printvalueitemindent
 item printvaluelabelsep
 item printvaluelabelwidth
 item printvaluelabelindent
endenumerate

enddocument