NAME

dbman_import.pl - import manual pages into the dbman database.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

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.

DETAILS

MANIFEST: dbman_import.pl
PROJECT: meta
VERSION: 0.08

SYNOPSIS

dbman_import.pl [options]

DESCRIPTION

This program imports the on-disk manual pages specified by a search path and puts them into the dbman RDBMS.

OPTIONS

help (type: bool, default: 0)

display help message

pod (type: bool, default: 0)

display pod options snipplet

man (type: bool, default: 0)

display manual page

quit (type: bool, default: 0)

quit without doing anything

gtk (type: bool, default: 0)

run a gtk ui to get the parameters

license (type: bool, default: 0)

show license and exit

show copyright and exit

description (type: bool, default: 0)

show description and exit

history (type: bool, default: 0)

show history and exit

connections_file (type: devf, default: xmlx/connections/connections.xml)

what connections XML file to use ?

con_name (type: stri, default: )

what connection name ?

name (type: stri, default: dbman)

what database name ?

verbose (type: bool, default: 0)

should I be noisy ?

clean (type: bool, default: 1)

should I clean the database before ?

sections (type: bool, default: 1)

import sections ?

pages (type: bool, default: 1)

import pages ?

demo (type: bool, default: 0)

fake it ?

import_description (type: bool, default: 1)

import description ?

import_troff (type: bool, default: 1)

import troff format ?

import_ascii (type: bool, default: 1)

import ascii format ?

import_ps (type: bool, default: 1)

import ps format ?

import_dvi (type: bool, default: 1)

import dvi format ?

import_html (type: bool, default: 1)

import html format ?

dirs (type: dlst, default: /local/tools/man)

directory path to scan

no free arguments are allowed

BUGS

None.

AUTHOR

Name: Mark Veltzer
Email: mailto:veltzer@cpan.org
WWW: http://www.veltzer.org
CPAN id: VELTZER

HISTORY

0.00 MV import tests
0.01 MV dbman package creation
0.02 MV more thumbnail issues
0.03 MV website construction
0.04 MV improve the movie db xml
0.05 MV web site automation
0.06 MV SEE ALSO section fix
0.07 MV move tests to modules
0.08 MV download scripts

SEE ALSO

Compress::Zlib(3), File::MMagic(3), Meta::Class::DBI(3), Meta::Db::Connections(3), Meta::Db::Dbi(3), Meta::Db::Ops(3), Meta::Projects::Dbman::Page(3), Meta::Projects::Dbman::Section(3), Meta::Tool::Groff(3), Meta::Utils::File::File(3), Meta::Utils::File::Iter(3), Meta::Utils::Opts::Opts(3), Meta::Utils::Output(3), Meta::Utils::Progress(3), Meta::Utils::System(3), strict(3)

TODO

-use time stamps and inodes in the database to determine if things need to be updated.

-take care of all the warnings that come out when doing a full import.

-make the db user and password and connection info also be read from a configuration file.

-do the ps,dvi and html importing.

-do file types with File::Mime or someting and not according to the file name.

-handle symbolic links by having multiple entries with the same manual content (two tables).

-make the ability to run man --path and get the result in order to get the actual directories. Actually make a man tool which can either run man --path or read the man conf files (/etc/man.config) to in order to get the relevant paths.