cleared the behaviour of firstnumber and includerangemarker in the documentation

1 files changed, 5 insertions, 1 deletions

diff --git a/listings.dtx b/listings.dtx
index 40b9cc9..41b07d5 100644
--- a/listings.dtx
+++ b/listings.dtx
@@ -2640,7 +2640,7 @@
 %     the number corresponding to the first input line.
 %
 %     \texttt{last} continues the numbering of the most recent listing and
-%     \meta{number} sets it to the number.
+%     \meta{number} sets it to the (logical) number.
 %
 %   \item[1.0] \rkeyname{name}|=|\meta{name}
 %
@@ -3984,6 +3984,10 @@
 % \item[1.2,true] \rkeyname{includerangemarker}|=|\meta{\alternative{true,false}}
 %
 %       shows or hides the markers in the output.
+%
+%       \textbf{Remark:} If |firstnumber| is set, it refers to
+%       the line which contains the marker. So if one wants to start a range with
+%       the number 1, one has to set |includerangemarker=false, firstnumber=0|.
 % \end{syntax}
 % \begin{lstsample}{\lstset{rangeprefix=\{\ ,rangesuffix=\ \}}}{}
 %    \begin{lstlisting}%