mirror of
https://github.com/zeek/zeek.git
synced 2025-10-02 14:48:21 +00:00
4ac6d0ae2e
- Fixing the parts of the `make restdoc` and `make doc` process that were broken by the last Bro script re-organization - Generated documentation for Bro scripts derived from BiFs now use the original BiF source file as the "original source file" link - Renaming of the internal POLICYDEST definition and other misc places that refer to "policy" scripts; that terminology doesn't make total sense now - Added a documentation blacklist reminder test that will fail if there's scripts that are blacklisted from being documentated because they're still in progress - Some minor Bro script changes to fix small @load dependency errors Addresses #543
87 lines
2.3 KiB
Bash
Executable file
87 lines
2.3 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
|
|
# ./genDocSourcesList.sh [output file]
|
|
#
|
|
# Run this script to a generate file that's used to tell CMake about all the
|
|
# possible scripts for which reST documentation can be created.
|
|
#
|
|
# The optional argument can be used to avoid overwriting the file CMake uses
|
|
# by default.
|
|
#
|
|
# Specific scripts can be blacklisted below when e.g. they currently aren't
|
|
# parseable or they just aren't meant to be documented.
|
|
|
|
blacklist ()
|
|
{
|
|
if [[ "$blacklist" == "" ]]; then
|
|
blacklist="$1"
|
|
else
|
|
blacklist="$blacklist|$1"
|
|
fi
|
|
}
|
|
|
|
# files passed into this function are meant to be temporary workarounds
|
|
# because they're not finished or otherwise can't be loaded for some reason
|
|
tmp_blacklist ()
|
|
{
|
|
echo "Warning: temporarily blacklisted files named '$1'" 1>&2
|
|
blacklist $1
|
|
}
|
|
|
|
blacklist __load__.bro
|
|
blacklist test-all.bro
|
|
blacklist all.bro
|
|
blacklist init-default.bro
|
|
blacklist init-bare.bro
|
|
|
|
tmp_blacklist hot.conn.bro
|
|
tmp_blacklist scan.bro
|
|
|
|
statictext="\
|
|
# DO NOT EDIT
|
|
# This file is auto-generated from the "genDocSourcesList.sh" script.
|
|
#
|
|
# This is a list of Bro script sources for which to generate reST documentation.
|
|
# It will be included inline in the CMakeLists.txt found in the same directory
|
|
# in order to create Makefile targets that define how to generate reST from
|
|
# a given Bro script.
|
|
#
|
|
# Note: any path prefix of the script (2nd argument of rest_target macro)
|
|
# will be used to derive what path under scripts/ the generated documentation
|
|
# will be placed.
|
|
|
|
set(psd \${PROJECT_SOURCE_DIR}/scripts)
|
|
|
|
rest_target(\${CMAKE_CURRENT_SOURCE_DIR} example.bro internal)
|
|
rest_target(\${psd} base/init-default.bro internal)
|
|
rest_target(\${psd} base/init-bare.bro internal)
|
|
"
|
|
|
|
if [[ $# -ge 1 ]]; then
|
|
outfile=$1
|
|
else
|
|
outfile=DocSourcesList.cmake
|
|
fi
|
|
|
|
thisdir="$( cd "$( dirname "$0" )" && pwd )"
|
|
sourcedir=${thisdir}/../..
|
|
|
|
echo "$statictext" > $outfile
|
|
|
|
bifs=`( cd ${sourcedir}/build/src && find . -name \*\.bro | sort )`
|
|
|
|
for file in $bifs
|
|
do
|
|
f=${file:2}
|
|
echo "rest_target(\${CMAKE_BINARY_DIR}/src $f)" >> $outfile
|
|
done
|
|
|
|
scriptfiles=`( cd ${sourcedir}/scripts && find . -name \*\.bro | sort )`
|
|
|
|
for file in $scriptfiles
|
|
do
|
|
f=${file:2}
|
|
if [[ ! $f =~ $blacklist ]]; then
|
|
echo "rest_target(\${psd} $f)" >> $outfile
|
|
fi
|
|
done
|