From: Vladimir Prus (ghost_at_[hidden])
Date: 2006-10-16 02:54:12
On Monday 16 October 2006 06:11, Rene Rivera wrote:
> +# Given a format and the info from a target,
What is "info from a target"?
> as given to a tag
> +# rule, returns for synthesized
"returns for" does not sound correct grammatically.
> name for the target. The format
> +# specifies which information from the target is place,
Is "d" missing at the end.
> and where
> +# it is placed to form the name. The individual elements of the format
> +# are evaluated and sequencially composed into the resulting name.
May I suggest the following rewording:
Given target name, project, and properties return string formatted
according to the passed format. Format is a list of various target
properties that must be represented in the result. For each element
of format, the corresponding property is obtained, and then all
obtained values are concatenated. The concatenated string is returned.
> +# The format options can be:
> +# <base>[joiner]
> +# :: The basename of the target name.
What is "[joiner]" here?
> +# <toolset>[joiner]
> +# :: The abbreviated toolset tag being used to build the target.
> +# <threading>[joiner]
> +# :: Indication of a multi-threaded build.
> +# <runtine>[joiner]
> +# :: Collective tag of the build runtime.
> +# <version:/version-feature | X.Y[.Z]/>[joiner]
> +# :: Short version tag taken from the given "version-feature"
> +# in the build properties. Or if not present the literal
> +# value as the version number.
> +# <property:/property-name/>[joiner]
> +# :: Direct lookup of the given property-name value in the
> +# build properties.
> +# otherwise
> +# :: The literal value of the format argument.
> +# For all, but the literal, format the value, if given, is taken as
Some words are missing here, I think. Did you mean "joiner" somewhere?
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk