Improve the markup of the ctld.conf man page

[allanjude]

Summary

Replace <var> with man page markup
Change sub-headings from 'command level' to 'command context'

[trasz]

Looks great, apart from a few nits below.

usr.sbin/ctld/ctl.conf.5

71–72

"Context" name is much better than "level", but it's still kind of inconsistent - few lines below it says "Opens a target configuration section". Perhaps we should call it "Global section" instead, or change "section" to "context" everywhere?

72

Perhaps the whole "The following statements are available at ..." line could be dropped, since it's redundant? Same for similar lines for other contexts.

240–241

The "/ prefixlen" part is optional; can it be reflected somehow? Same for the other initiator-portal occurrence below.

[allanjude]

Added a lot more markup, and made it more consistent
Improved the sentence flow
Normalized some of the text.

Change the order of some definitions from:

1. Description
2. what happens if you don't define it
3. otherwise, this happens (if it is defined)

to the more logical flow of:

1. Description
2. What happens when it is defined
3. What happens when it is not defined

[trasz]

Looks perfect, thanks!

[allanjude]

Cross-refrence the ctladm(8) man page for CTL-specific options

[wblock]

usr.sbin/ctld/ctl.conf.5

75

Active: s/Creates/Create/

81

In this and following entries, "Specifies" is redundant. This can just be
"The debug verbosity level."

93

s/Creates/Create/

98

s/Creates/Create/

158

s/Assigns/Assign/

184

s/Assigns/Assign/

187

s/Assigns/Assign/

[allanjude]

Apply fixes suggested by wblock@

[bcr]

I make it a point not to disagree with trasz when he is right and has approved a man page. ;-)

[allanjude]

Update man page for commit

[allanjude]

Committed as rS271445 and fixed in rS271446

usr.sbin/ctld/ctl.conf.5

72

Yes, I'd say remove it, it is redundant.

If we kept it, I'd reword it as "The following configuration directives are available in the Global Context"

240–241

Square brackets [] are generally used to denote optional arguments. I'll add those

[allanjude]

Edward pointed out an ambiguity in the text

[allanjude]

Proposed fix

[bcr]

I'm fine with the proposed fix = approved!

[allanjude]

Committed as rS271560