diff --git a/doc/src/extending.xml b/doc/src/extending.xml
index 625649100..f5665b45a 100644
--- a/doc/src/extending.xml
+++ b/doc/src/extending.xml
@@ -181,8 +181,9 @@ local t = [ new file-target $(name) : CPP : $(project) : $(a) ] ;
once with the same properties. Returning to different instance of file-target
that correspond to the same file clearly will result in problems. Therefore, whenever
returning targets you should pass them via the virtual-target.register
- function, that will replace targets with previously created identical ones, as
- necessary.This create-then-register pattern is caused by limitations
+ function, besides allowing Boost Build to track which virtual targets
+ got created for each metatarget, this will also replace targets with previously created identical
+ ones, as necessary.This create-then-register pattern is caused by limitations
of the Boost.Jam language. Python port is likely to never create duplicate targets.
Here are a couple of examples: