nnrp conf

[Julien ÉLIE]

Hi Edwardo,

>>      auth example.com {
>>          hosts: "*.example.com, example.com"
>>          default: <LOCAL>
>>      }
>>
>>      access full {
>>          newsgroups: *
>>      }
>
> this brackets comment with LOCAL says localhost , so much confusion,

I suggest the following wording for the documentation.
Would it be clear enough or should something else be explained?


«
Probably the simplest useful example of a complete readers.conf,
this gives permissions to read and post to all groups to any connections
from the "example.com" domain, and no privileges for anyone connecting
elsewhere:

     auth example.com {
         hosts: "*.example.com, example.com"
         default: "<EXAMPLE>"
     }

     access full {
         newsgroups: *
     }

Note that the access realm has no users: key and therefore applies
to any user identity (in this example, the user identity that will be
assigned to all matching connections is <EXAMPLE>).  The only
available auth realm only matches hosts in the "example.com" domain,
though, so any connections from other hosts will be rejected immediately.
»

-- 
Julien ÉLIE

« Science sans conscience n'est que ruine de l'âme. » (Rabelais)