*! version 1.0.0 07dec2017

Title

packagefilebuilder -- Create a simple package file (pkg)
from a folder in the current directory.

Syntax

packagefilebuilder
packagename
[, options]

Main
replace replace an existing -pkg- file

noado do not include -ado- files

nosthlp do not include help files

do include -do- files

dta include data files

Description

packagefilebuilder creates a simple package file (pkg)
from a specified folder in the current directory. It is
intended for quick creation of a user-site that has fairly
limited installation instructions, for example class or
workshop materials.

Options

Main

replace replaces an existing -pkg- file. This is required if
such a file exists.

noado specifies that -ado- files not be included among the
package files that users can install.

nosthlp specifies that Stata help files not be included among the
package files that users can install.

do specifies that Stata -do- files should be included among the
package files that users can install. These are automatically
listed as ancillary files.

dta specifies that Stata data files should be included among the
package files that users can install. These are automatically
listed as ancillary files.

Remarks

packagefilebuilder creates a simple package file (pkg)
from a specified folder in the current directory. All of
the files to be distributed in the package must reside in
the same subfolder.

This command requires a template for the pkg file,
named PackageTemplate.txt, which contains all the
information about the package(s) except the list of files
to include.

This command is meant to be run in the directory where
the user-site table-of-contents file (stata.toc) is to
be located. The template should also be located in this
same directory.

By default, -ado- and help files are included (program
files, the normal package files). Optionally
the inclusion of these files can be suppressed.
Additionally, -do- files and data files may be included
(ancillary files). Any combination is valid.

Examples

location of your user-site

. cd "Z:/PUBLIC_web/testsite

Package up files in mypackage

. packagebuilder mypackage, replace

net from the user site

. net from "https://www.ssc.wisc.edu/~hemken/testsite"

. net describe mypackage

. net install mypackage