changeset 4149:5d9f4688590a

[project @ 2002-11-02 04:35:17 by jwe]
author jwe
date Sat, 02 Nov 2002 04:35:28 +0000
parents dc912f90db92
children 0d411821682c
files doc/ChangeLog doc/interpreter/Makefile.in doc/interpreter/mkoctfile.1
diffstat 3 files changed, 102 insertions(+), 10 deletions(-) [+]
line wrap: on
line diff
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,12 @@
+2002-11-01  Dirk Eddelbuettel <edd@debian.org>
+
+	* interpreter/Makefile.in (MAN_BASE, MAN_SRC): New variables, use
+	as appropriate.
+
+2002-11-01  John W. Eaton  <jwe@bevo.che.wisc.edu>
+
+ 	* interpreter/mkoctfile.1: New file.
+	
 2002-10-25  Paul Kienzle <pkienzle@users.sf.net>
 
 	* interpreter/Makefile.in (octave_toc.html): Use -expandinfo and
--- a/doc/interpreter/Makefile.in
+++ b/doc/interpreter/Makefile.in
@@ -38,13 +38,16 @@
 
 FORMATTED = octave.dvi octave.ps octave.info octave.info-[0-9]* octave_*.html
 
-DISTFILES = Makefile.in dir munge-texi.cc Map-s.cc octave.1 octave-bug.1 \
+MAN_BASE := mkoctfile octave octave-bug
+MAN_SRC := $(addsuffix .1, $(MAN_BASE))
+
+DISTFILES = Makefile.in dir munge-texi.cc Map-s.cc $(MAN_SRC) \
   $(SOURCES) $(TEXINFO) $(FORMATTED)
 
 ifeq ($(wildcard octave.info), )
-  BINDISTFILES = $(addprefix $(srcdir)/, octave.1 octave-bug.1 $(FORMATTED))
+  BINDISTFILES = $(addprefix $(srcdir)/, $(MAN_SRC) $(FORMATTED))
 else
-  BINDISTFILES = $(srcdir)/octave.1 $(srcdir)/octave-bug.1 $(FORMATTED)
+  BINDISTFILES = $(addprefix $(srcdir)/, $(MAN_SRC)) $(FORMATTED)
 endif
 
 # Look for version.h to get version information.
@@ -121,12 +124,11 @@
 install install-strip: all
 	$(top_srcdir)/mkinstalldirs $(man1dir) $(infodir)
 	@if test -d $(man1dir); then \
-	  rm -f $(man1dir)/octave$(man1ext); \
-	  echo "installing $(srcdir)/octave.1 in $(man1dir)"; \
-	  $(INSTALL_DATA) $(srcdir)/octave.1 $(man1dir)/octave$(man1ext); \
-	  rm -f $(man1dir)/octave-bug$(man1ext); \
-	  echo "installing $(srcdir)/octave-bug.1 in $(man1dir)"; \
-	  $(INSTALL_DATA) $(srcdir)/octave-bug.1 $(man1dir)/octave-bug$(man1ext); \
+	  for f in $(MAN_BASE); do \
+	    rm -f $(man1dir)/$$f$(man1ext); \
+	    echo "installing $(srcdir)/$$f.1 in $(man1dir)"; \
+	    $(INSTALL_DATA) $(srcdir)/$$f.1 $(man1dir)/$$f$(man1ext); \
+	  done ; \
 	fi
 	@if test -d $(infodir); then \
 	  rm -f $(infodir)/octave.info*; \
@@ -161,7 +163,8 @@
 .PHONY: install install-strip
 
 uninstall:
-	rm -f $(infodir)/octave.info* $(man1dir)/octave$(man1ext)
+	rm -f $(infodir)/octave.info*
+	for f in $(MAN_BASE); do rm -f $(man1dir)/$$f$(man1ext); done
 .PHONY: uninstall
 
 tags: $(SOURCES)
new file mode 100644
--- /dev/null
+++ b/doc/interpreter/mkoctfile.1
@@ -0,0 +1,80 @@
+.\" Man page contributed by Dirk Eddelbuettel <edd@debian.org>
+.\" and released under the GNU GPL
+.TH MKOCTFILE 1 "1 November 2002" "GNU Octave"
+.SH NAME
+mkoctfile - Compile dynamic-load modules for GNU Octave
+.SH SYNOPSIS
+.BR mkoctfile\  [-IDIR]\ [-DDEF]\ [-lLIB]\ [-LDIR]\ [-M|--depend]\ 
+[-c]\ [-o FILE|--output FILE]\ [-p VAR|--print VAR]\ [-s|\--strip]\ 
+[-v|--verbose]\ [-h|-?|--help]\ \fIfile\fP .\|.\|.  
+.SH DESCRIPTION
+.PP
+\fImkoctfile\fP is used to compile source C, C++ or Fortran source code in
+dynamically loadble 
+.f .oct
+file for 
+.BR octave (1).
+.SH OPTIONS
+.l
+\fImkoctfile\fP accepts the following options:
+.TP 8
+.B \-IDIR
+Add include directory DIR to compile commands.
+.TP 8
+.B \-DDEF
+Add definition DEF to compiler call.
+.TP 8
+.B \-lLIB
+Add library LIB to link command.
+.TP 8
+.B \-LDIR
+Add library directory DIR to link command.
+.TP 8
+.B \-M|\-\-depend
+Generate dependency files (.d) for C and C++ source files.
+.TP 8
+.B \-c
+Compile but do not link.
+.TP 8
+.B \-o FILE|\-\-output FILE
+Output file name; default extension is .oct.
+.TP
+.B \-p VAR|\-\-print VAR
+Print configuration variable VAR.  Recognized variables are:
+.RS
+    CPPFLAGS    CPICFLAG
+    INCFLAGS    CXX
+    F2C         CXXFLAGS
+    F2CFLAGS    CXXPICFLAG
+    F77         XTRA_CFLAGS
+    FFLAGS      XTRA_CXXFLAGS
+    FPICFLAG    SHLEXT
+    CC          SH_LD
+    CFLAGS      SH_LDFLAGS
+.RE
+.TP 8
+.B \-s|--strip
+Strip the output file.
+.TP 8
+.B \-v|--verbose
+Echo commands as they are executed.
+.TP 8
+.B file
+Compile or linke file. Recognised file types are 
+.RS
+    .c    C source
+    .cc   C++ source
+    .C    C++ source
+    .cpp  C++ source
+    .f    Fortran source
+    .F    Fortran source
+    .o    object file
+    .SH SEE ALSO
+    .BR octave (1).
+.RE
+.SH AUTHOR
+John W. Eaton <jwe@bevo.che.wisc.edu>
+
+This manual page was contributed by Dirk Eddelbuettel
+<edd@debian.org> for the Debian GNU/Linux distribution but 
+may be used by others.