X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2FMakefile.am;h=55ae2c653119d7bb2a30fa56581eaf2aadd953ae;hb=ce2e28b769a1a338ddc3f8d4078cff4f3dfab3d9;hp=d285f2aaf944867f0280d3675c2a504f14d8735e;hpb=f66373b5f898e3c3f7ae0c3306f38786ccf3338e;p=fs%2Flustre-release.git

diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am
index d285f2a..3e908f2 100644
--- a/lustre/doc/Makefile.am
+++ b/lustre/doc/Makefile.am
@@ -1,66 +1,205 @@
-# Copyright (C) 2001, 2002 Cluster File Systems, Inc.
 #
-# This code is issued under the GNU General Public License.
-# See the file COPYING in this distribution
-LYX2PDF = lyx --export pdf
-LYX2TXT = lyx --export text
-LYX2HTML = lyx --export html
-SUFFIXES = .lyx .pdf .sgml .html .txt .fig .eps
-
-DOCS = lustre.pdf lustre-HOWTO.txt
-IMAGES =  cache1.eps cache2.eps intermezzocache.eps intermezzofilesys.eps meta.eps metadata1.eps networklayer.eps bigpicture.eps intermezzo.eps mds.eps portals.eps client.eps layering.eps metadata.eps sb.eps cow.eps lockacq.eps obdfs.eps snapsetup.eps dirbodyapi.eps loraid.eps ost.eps updates.eps hotmigrate.eps lustreclusters.eps osthw.eps portals-lib.eps lockqueues.eps lockexample1.eps lockexample2.eps lockexample3.eps lockexample4.eps lockseverity.eps
-LYXFILES= master.lyx evolution.lyx  llocks.lyx mgmt.lyx uncertain.lyx\
-	fs.lyx         lustre-HOWTO.lyx      namespace.lyx\
-	glossary.lyx   lustre-debugging.lyx  network.lyx\
-	intro.lyx      obdspec.lyx recovery.lyx
-
-MAINTAINERCLEANFILES =  $(IMAGES) $(DOCS) lustre-HOWTO.lyx
-CLEANFILES = *.lyxT
-
-EXTRA_DIST = $(DOCS) $(IMAGES) $(LYXFILES) DOCVERSION master.bib
-
-all: $(DOCS)
-
-# update date and version in document
-tag := $(shell cat $(srcdir)/CVS/Tag 2>/dev/null || echo HEAD)
-addstamp = sed "s|^Date:.*|Date: `date +%x`|g; s|^Version:.*|Version: $(tag)|g"
+# GPL HEADER START
+#
+# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License version 2 only,
+# as published by the Free Software Foundation.
+#
+# 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 version 2 for more details (a copy is included
+# in the LICENSE file that accompanied this code).
+#
+# You should have received a copy of the GNU General Public License
+# version 2 along with this program; If not, see
+# http://www.gnu.org/licenses/gpl-2.0.html
+#
+# GPL HEADER END
+#
 
-DOCVERSION:
-	echo $(tag) > DOCVERSION
+#
+# Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
+# Use is subject to license terms.
+#
+# Copyright (c) 2011, 2017, Intel Corporation.
+#
 
-.lyx.pdf:
-	rm -f $<T
-	$(addstamp) $< > $<T
-	@$(LYX2PDF) $< || printf "\n*** Warning: not creating PDF docs; install lyx to rectify this\n"
-	rm -f $<T
+#
+# This file is part of Lustre, http://www.lustre.org/
+# Lustre is a trademark of Sun Microsystems, Inc.
+#
 
-.lyx.txt:
-	rm -f $<T
-	$(addstamp) $< > $<T
-	@$(LYX2TXT) $< || printf "\n*** Warning: not creating text docs; install lyx to rectify this\n"
-	rm -f $<T
+MANFILES =					\
+	lctl.8					\
+	lctl-get_param.8			\
+	lctl-list_param.8			\
+	lctl-network.8				\
+	lctl-pcc.8				\
+	lctl-set_param.8			\
+	ldev.8					\
+	ldev.conf.5				\
+	lfs.1					\
+	lfs-df.1				\
+	lfs-fid2path.1				\
+	lfs-find.1				\
+	lfs-getstripe.1				\
+	lfs-getdirstripe.1			\
+	lfs-heat.1				\
+	lfs-hsm.1				\
+	lfs-ladvise.1				\
+	lfs_migrate.1				\
+	lfs-migrate.1				\
+	lfs-mirror-create.1			\
+	lfs-mirror-delete.1			\
+	lfs-mirror-extend.1			\
+	lfs-mirror-resync.1			\
+	lfs-mirror-split.1			\
+	lfs-mirror-verify.1			\
+	lfs-mkdir.1				\
+	lfs-path2fid.1				\
+	lfs-pcc.1				\
+	lfs-pcc-detach.1			\
+	lfs-project.1				\
+	lfs-setdirstripe.1			\
+	lfs-setstripe.1				\
+	lfs-setquota.1				\
+	l_getidentity.8				\
+	lgss_sk.8				\
+	lhbadm.8				\
+	llapi_create_volatile_param.3		\
+	llapi_fd2parent.3			\
+	llapi_file_create.3			\
+	llapi_file_create_foreign.3		\
+	llapi_file_get_stripe.3			\
+	llapi_file_open.3			\
+	llapi_group_lock.3			\
+	llapi_group_unlock.3			\
+	llapi_heat_get.3			\
+	llapi_heat_set.3			\
+	llapi_hsm_action_begin.3		\
+	llapi_hsm_action_end.3			\
+	llapi_hsm_action_get_dfid.3		\
+	llapi_hsm_action_get_fd.3		\
+	llapi_hsm_action_progress.3		\
+	llapi_hsm_copytool_get_fd.3		\
+	llapi_hsm_copytool_recv.3		\
+	llapi_hsm_copytool_register.3		\
+	llapi_hsm_copytool_unregister.3		\
+	llapi_hsm_state_get.3			\
+	llapi_hsm_state_set.3			\
+	llapi_ladvise.3				\
+	llapi_layout.7				\
+	llapi_layout_alloc.3			\
+	llapi_layout_comp_add.3			\
+	llapi_layout_comp_del.3			\
+	llapi_layout_comp_extent_get.3		\
+	llapi_layout_comp_extent_set.3		\
+	llapi_layout_comp_flags_clear.3		\
+	llapi_layout_comp_flags_get.3		\
+	llapi_layout_comp_flags_set.3		\
+	llapi_layout_comp_id_get.3		\
+	llapi_layout_comp_use.3			\
+	llapi_layout_comp_use_id.3		\
+	llapi_layout_file_comp_add.3		\
+	llapi_layout_file_comp_del.3		\
+	llapi_layout_file_create.3		\
+	llapi_layout_file_open.3		\
+	llapi_layout_free.3			\
+	llapi_layout_get_by_fd.3		\
+	llapi_layout_get_by_fid.3		\
+	llapi_layout_get_by_path.3		\
+	llapi_layout_get_by_xattr.3		\
+	llapi_layout_ost_index_get.3		\
+	llapi_layout_ost_index_set.3		\
+	llapi_layout_pattern_get.3		\
+	llapi_layout_pattern_set.3		\
+	llapi_layout_pool_name_get.3		\
+	llapi_layout_pool_name_set.3		\
+	llapi_layout_stripe_count_get.3		\
+	llapi_layout_stripe_count_set.3		\
+	llapi_layout_stripe_size_get.3		\
+	llapi_layout_stripe_size_set.3		\
+	llapi_path2fid.3			\
+	llapi_path2parent.3			\
+	llapi_quotactl.3			\
+	llapi_pcc_attach.3			\
+	llapi_pcc_attach_fid.3			\
+	llapi_pcc_attach_fid_str.3		\
+	llapi_pcc_detach_fid.3			\
+	llapi_pcc_detach_fid_fd.3		\
+	llapi_pcc_detach_fid_str.3		\
+	llapi_pcc_detach_file.3		\
+	llapi_pccdev_get.3			\
+	llapi_pccdev_set.3			\
+	llapi_pcc_state_get.3			\
+	llapi_pcc_state_get_fd.3			\
+	ll_decode_linkea.8			\
+	llobdstat.8				\
+	llog_reader.8				\
+	llsom_sync.8				\
+	llstat.8				\
+	lnetctl.8				\
+	lst.8					\
+	lustre.7				\
+	lustreapi.7				\
+	lustre_routes_config.8			\
+	lustre_routes_conversion.8		\
+	lustre_rsync.8				\
+	mount.lustre.8				\
+	mount.lustre_tgt.8			\
+	nids.5					\
+	plot-llstat.8				\
+	routerstat.8
 
-.lyx.html:
-	rm -f $<T
-	$(addstamp) $< > $<T
-	@$(LYX2HTML) $< || printf "\n*** Warning: not creating HTML docs; install lyx to rectify this\n"
-	rm -f $<T
+SERVER_MANFILES =				\
+	lctl-barrier.8				\
+	lctl-lcfg.8				\
+	lctl-lfsck-query.8			\
+	lctl-lfsck-start.8			\
+	lctl-lfsck-stop.8			\
+	lctl-llog_cancel.8			\
+	lctl-llog_catlist.8			\
+	lctl-llog_info.8			\
+	lctl-llog_print.8			\
+	lctl-nodemap-activate.8			\
+	lctl-nodemap-add.8			\
+	lctl-nodemap-add-idmap.8		\
+	lctl-nodemap-add-range.8		\
+	lctl-nodemap-del.8			\
+	lctl-nodemap-del-idmap.8		\
+	lctl-nodemap-del-range.8		\
+	lctl-nodemap-modify.8			\
+	lctl-nodemap-set-fileset.8		\
+	lctl-nodemap-set-sepol.8		\
+	lctl-snapshot-create.8			\
+	lctl-snapshot-destroy.8			\
+	lctl-snapshot-list.8			\
+	lctl-snapshot-modify.8			\
+	lctl-snapshot-mount.8			\
+	lctl-snapshot-umount.8			\
+	ll_decode_filter_fid.8			\
+	llverdev.8				\
+	lshowmount.8				\
+	mkfs.lustre.8				\
+	tunefs.lustre.8
 
-.fig.eps:
-	-fig2dev -L eps $< > $@
+if SERVER
+MANFILES += $(SERVER_MANFILES)
+else
+DISTONLY_MANFILES = $(SERVER_MANFILES)
+endif
 
-lustre.lyx: master.lyx $(IMAGES) DOCVERSION
-	(ver="`cat DOCVERSION`" ;\
-	echo "version for $< is $$ver";\
-	sed "s/VERSION/version $$ver/" < $< > lustre.lyx.tmp ;\
-	thedate=`date +%x` ; sed "s:DATE:$$thedate , :" < lustre.lyx.tmp > lustre.lyx ;\
-	)
+if UTILS
+if MANPAGES
+man_MANS = $(MANFILES)
+endif
+endif
 
-syncweb: lustre.pdf
-	cp lustre.pdf /usr/src/www/content/lustre/docs/lustre.pdf
-	( cd /usr/src/www ; make lustre ; make synclustre )
+CLEANFILES = *.aux *.tex *.log *.pdf
 
-dist-hook:
-	rm -rf $(distdir)/figs/CVS
+EXTRA_DIST = $(MANFILES) $(DISTONLY_MANFILES)
 
-include $(top_srcdir)/Rules
+all: