[doc] SYNOPSIS Net::LDAP::LDIF->new

[sjvudp]

Where
Net::LDAP::LDIF

Description

I found an old-time bug in the POD for Net::LDAP::LDIF(3):
The SYNOPSIS says:

$ldif = Net::LDAP::LDIF->new( "file.ldif", "r", onerror => 'undef' );

But later on it says:

onerror => 'die' | 'warn' | undef

Note that “undef” is not quoted, meaning the undef value, not the string “undef”.
I guess the undef value is actually meant. Unfortunately the wrong SYNOPSIS made many users (e.g. myself) copy and use the wrong code…

[mauke]

1. Net::LDAP::LDIF is not a core module; its bugtracker is at https://github.com/perl-ldap/perl-ldap/issues/.
2. The code in the SYNOPSIS is correct: 'undef' is supposed to be a string.
3. The documentation says onerror => 'die' | 'warn' | 'undef'. It has done so since perl-ldap/perl-ldap@22cd8d5 (released six years ago as part of version 0.66).