------------------------------------------------------------ revno: 13679 revision-id: squid3@treenet.co.nz-20141208083222-hvpo4mah68920ni9 parent: squid3@treenet.co.nz-20141208083128-a3zzjag4sckbn2i1 committer: Amos Jeffries branch nick: 3.5 timestamp: Mon 2014-12-08 00:32:22 -0800 message: basic_pop3_auth: Add man(8) documentation ------------------------------------------------------------ # Bazaar merge directive format 2 (Bazaar 0.90) # revision_id: squid3@treenet.co.nz-20141208083222-hvpo4mah68920ni9 # target_branch: http://bzr.squid-cache.org/bzr/squid3/3.5 # testament_sha1: 839e5f33b58eadce167a112d77415f770be64ba4 # timestamp: 2014-12-08 08:51:14 +0000 # source_branch: http://bzr.squid-cache.org/bzr/squid3/3.5 # base_revision_id: squid3@treenet.co.nz-20141208083128-\ # a3zzjag4sckbn2i1 # # Begin patch === modified file 'helpers/basic_auth/POP3/Makefile.am' --- helpers/basic_auth/POP3/Makefile.am 2014-09-02 01:08:58 +0000 +++ helpers/basic_auth/POP3/Makefile.am 2014-12-08 08:32:22 +0000 @@ -8,8 +8,16 @@ include $(top_srcdir)/src/Common.am libexec_SCRIPTS = basic_pop3_auth -EXTRA_DIST = basic_pop3_auth.pl.in required.m4 -CLEANFILES += basic_pop3_auth +man_MANS= basic_pop3_auth.8 +EXTRA_DIST= \ + basic_pop3_auth.8 \ + basic_pop3_auth.pl.in \ + required.m4 basic_pop3_auth: basic_pop3_auth.pl.in $(subst_perlshell) + +basic_pop3_auth.8: basic_pop3_auth + pod2man basic_pop3_auth basic_pop3_auth.8 + +CLEANFILES += basic_pop3_auth basic_pop3_auth.8 === modified file 'helpers/basic_auth/POP3/basic_pop3_auth.pl.in' --- helpers/basic_auth/POP3/basic_pop3_auth.pl.in 2014-09-13 13:31:49 +0000 +++ helpers/basic_auth/POP3/basic_pop3_auth.pl.in 2014-12-08 08:32:22 +0000 @@ -1,32 +1,85 @@ #!@PERL@ -## -## Copyright (C) 1996-2014 The Squid Software Foundation and contributors -## -## Squid software is distributed under GPLv2+ license and includes -## contributions from numerous individuals and organizations. -## Please see the COPYING and CONTRIBUTORS files for details. -## - -# POP3 authenticator for Squid -# Copyright (C) 2006 Henrik Nordstrom -# -# This program is free software; you can redistribute it and/or modify -# it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or -# (at your option) any later version. -# -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -# GNU General Public License for more details. -# -# You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. -# -# Change log: -# 2006-12-10 henrik Initial revision -# + +use strict; +use Pod::Usage; +use Getopt::Long; + +=pod + +=head1 NAME + + basic_pop3_auth - POP3 authenticator for Squid + +=head1 SYNOPSIS + + basic_pop3_auth server + +=head1 DESCRIPTION + +B authenticates user credentials against a POP3 server. + +=head1 OPTIONS + +The only option this helper takes is the name of the POP3 server to validate against. + +=head1 AUTHOR + +This program was written by I> + +This manual was written by I> + +=head1 COPYRIGHT + + * Copyright (C) 1996-2014 The Squid Software Foundation and contributors + * + * Squid software is distributed under GPLv2+ license and includes + * contributions from numerous individuals and organizations. + * Please see the COPYING and CONTRIBUTORS files for details. + + # Copyright (C) 2006 Henrik Nordstrom + # + # This program is free software; you can redistribute it and/or modify + # it under the terms of the GNU General Public License as published by + # the Free Software Foundation; either version 2 of the License, or + # (at your option) any later version. + # + # This program is distributed in the hope that it will be useful, + # but WITHOUT ANY WARRANTY; without even the implied warranty of + # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + # GNU General Public License for more details. + # + # You should have received a copy of the GNU General Public License + # along with this program; if not, write to the Free Software + # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. + # + # Change log: + # 2006-12-10 henrik Initial revision + # + +=head1 QUESTIONS + +Questions on the usage of this program can be sent to the I> + +=head1 REPORTING BUGS + +Bug reports need to be made in English. +See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. + +Report bugs or bug fixes using http://bugs.squid-cache.org/ + +Report serious security bugs to I> + +Report ideas for new improvements to the I> + +=head1 SEE ALSO + +squid (8), GPL (7), + +The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq + +The Squid Configuration Manual http://www.squid-cache.org/Doc/config/ + +=cut use Net::POP3; $|=1; === modified file 'helpers/basic_auth/POP3/required.m4' --- helpers/basic_auth/POP3/required.m4 2014-09-02 01:08:58 +0000 +++ helpers/basic_auth/POP3/required.m4 2014-12-08 08:32:22 +0000 @@ -5,4 +5,6 @@ ## Please see the COPYING and CONTRIBUTORS files for details. ## -BUILD_HELPER="POP3" +if test "x$PERL" != "x" -a "x$POD2MAN" != "x"; then + BUILD_HELPER="POP3" +fi