porters-handbook: Add more example in the advanced pkg-plist

[dbaio]

Summary

porters-handbook/plist-config.html

[mat]

Not sure why this is needed. Options generated PLIST_SUB entries always go at the start of the line.

[dbaio]

In D16598#352729, @mat wrote:

Not sure why this is needed. Options generated PLIST_SUB entries always go at the start of the line.

I thought about this tip because of this:

tomcat85-pkgplist
tomcat9-pkgplist

And to be honest, I was in doubt when I saw @sample %%OPTION%% in the port and I needed to test.

I know this can be a one time issue only, but IMHO it won't cause any harm.

[mat]

It is only an issue if you do not test, right. All PLIST option helpers add @comment to comment the line out, so it does not make much sense in the middle of the line. It shows a real lack of understanding of what is going on.

I feel this is the wrong place for this, as it is not specific to @sample.

[dbaio]

Is this location better?

See here

I found another port with this issue.
/net-mgmt/icinga-core/pkg-plist:

@sample %%IDOUTILS%%%%ETCDIR%%/ido2db.cfg.sample
@sample %%IDOUTILS%%%%ETCDIR%%/idomod.cfg.sample
@sample %%IDOUTILS%%%%ETCDIR%%/modules/idoutils.cfg.sample

[dbaio]

Typo

[mat]

Moved it out of a specific section, and reworded a bit, thanks for the patch.

[dbaio]

Thank you