Re: [Boost-build] CVS: boost/tools/build/v2/tools common.jam, 1.49, 1.50

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?

- Volodya