TABLE OF CONTENTS


Config/Makefile [ Modules ]

[ Top ] [ Modules ]

NAME

Makefile -- supporting makefile targets for maintaining Config.

SYNOPSIS

cd Config; make <target>

PURPOSE

This makefile includes targets for auditing files comparing what exists in the config tree against the files deployed by the Rdist distfile. Also it has targets for generating on-line documentation for the rdist mechanism.


Config/Makefile/audit [ Targets ]

[ Top ] [ Targets ]

NAME

audit -- Makefile target for comparing rdisted against checked in files.

SYNOPSIS

cd Config; make audit

PURPOSE

This target allows auditing files comparing what exists in the config tree against the files deployed by the Rdist distfile. It uses the source code control system (e.g. svn ls -R) to list all files checked into the repository that are by definition available to be rdisted. It also extracts a list of files from the distfile. It then generates a three column list comparing the two file lists. If a file exists only in the distfile, it is in the far left column and is prefixed with a "d". If it exists only in the source code repository, it starts in the middle column and is prefixed with an "s" for source. If it is matched in both lists, it starts in the third column and is prefixed with a "b" for both.

EXAMPLE

The output of "make audit" shows:

    f       netdev/alteons/allegheny.txt
    f       netdev/alteons/magdalena.txt
    f       nsswitch/
    b               nsswitch/nsswitch.conf.ldap
    b               nsswitch/nsswitch.conf.noldap
    f       ntp/
    b               ntp/clients.conf
    d ntp/dist/ntp_root1.conf
    d ntp/dist/ntp_root2.conf
    d ntp/dist/ntp_root3.conf
    f       ntp/hosts/
    b               ntp/hosts/forth.ntp.conf
    b               ntp/hosts/thames.ntp.conf
    f       ntp/ntp_root.conf

Which shows the generated files: ntp/dist/ntp_root?.conf present in the distfile, but not being pushed. The ntp/clients.conf file shows up in both sets of output. This isn't a great mechanism, but it does provide a way of seeing what files are present and not pushed.


Config/Makefile/docs [ Targets ]

[ Top ] [ Targets ]

NAME

docs -- Extract robodoc comments from files in Config tree.

SYNOPSIS

cd Config; make docs

PURPOSE

This target generates documentation in the Config/docs subdirectory extracted using robodoc from the files in the tree.