+2002-08-04 Rune Zedeler <rune@zedeler.dk>
+
+ * Documentation/user/refman.itely
+ * Documentation/user/internals.itely: Documented "Current" property.
+
2002-08-04 Han-Wen <hanwen@cs.uu.nl>
* lily/lily-guile.cc: change gh_str02scm to scm_makfrom0str.
@internalsref{Voice} context can be set in the @internalsref{Score} context (for
example) and thus take effect in all @internalsref{Voice} contexts.
+@cindex @code{Current}
+If you don't wish to specify the name of the context in the
+@code{\property}-expression
+itself, you can refer to the abstract context name,
+@code{Current}. The @code{Current} context is the latest
+used context. This will typically mean the @internalsref{Thread}
+context, but you can force another context with the
+@code{\property}-command. Hence the expressions
+
+@example
+ \property @var{contextname}.@var{propname} = @var{value}
+@end example
+
+and
+
+@example
+ \context @var{contextname}
+ \property Current.@var{propname} = @var{value}
+@end example
+
+do the same thing.
+The main use for this is in macros - allowing the specification of a
+property-setting without restriction to a specific context.
+
Properties can be unset using the following expression:
@example
\property @var{contextname}.@var{propname} \unset
additional @code{\relative} inside the @code{\transpose}.
-@c . {Bar check}
+@c . {Bar check}
@node Bar check
@subsection Bar check
@cindex Bar check
@file{ly/property-init.ly}.
@cindex @file{property-init.ly}
-The normal way of using the macros is to enter the macro name right after the
+The macros operate on the ``Current'' context (see @ref{Context properties}). This
+means that the macros shuold normally be invoked right after the
creation of the context in which the accidental typesetting described
by the macro is to take effect. I.e. if you want to use
piano-accidentals in a pianostaff then you issue