interchange / xmldocs

Interchange new documentation (XML source)
http://www.icdevgroup.org/
4 stars 3 forks source link

RT Ticket #148: reparse parameter #14

Open phinjensen opened 11 years ago

phinjensen commented 11 years ago

Created: Tue Dec 18 13:59:36 2007 Owner: Stefan Hornburg Requestors: Kevin Walsh


Several of the tags list the reparse parameter even though the tags don't return anything. The reparse parameter is pointless if the tag will never return a value, so there's no point in listing the parameter in this case.

A few examples:

write-relative-file, set, seti, tmp, tmpn, set-cookie

There are a lot more, but basically reparse is only a viable option if the tag is designed to return a value.

Non-container tags use interpolate instead of reparse to control whether or not the output is parsed.

Even that rule isn't complete: there are tags, such as [area], that return a value that will never be affected by the reparse/interpolate parameter.

Sticking with [area] for a moment. The [area] tag says:

interpolate = interpolate input?

reparse = reparse output?

  1. there is no input, as [area] is not a container tag.
  2. the output is unaffected by reparse (and by interpolate for that matter).