Files
mercury/doc/generate_mdb_doc
Zoltan Somogyi a06ae2c6ef Simplify the code of the mdb help system.
browser/help.m:
    Simplify the data types representing the nested structure
    of help information. Simplify the code of the predicates
    that work on that structure.

    Simplify some of the predicates, e.g. by having a search predicate
    do *just* search.

    Give types and predicates more meaningful names. Make argument order
    more suitable for state-variables. Move a predicate next to its
    only call site.

browser/declarative_user.m:
    Conform to the change in help.m.

    Replace two bools with values of bespoke types.

browser/declarative_debugger.m:
browser/declarative_oracle.m:
    Conform to the changes in help.m and declarative_user.m.

doc/generate_mdb_doc:
    Fix the vim modeline.

trace/mercury_trace_declarative.c:
trace/mercury_trace_help.c:
    Conform to the changes in the browser directory.

util/info_to_mdb.c:
    Switch from /**/ to // for comments.

    Give a macro a meaningful name.

    Fix indentation.
2020-08-14 11:04:17 +10:00

49 lines
1.9 KiB
Bash
Executable File

#!/bin/sh
# vim: sw=4 ts=4 et
#---------------------------------------------------------------------------#
# Copyright (C) 1998-1999,2002, 2004-2006 The University of Melbourne.
# This file may only be copied under the terms of the GNU General
# Public License - see the file COPYING in the Mercury distribution.
#---------------------------------------------------------------------------#
# The info menu items that get us to the chapter on debugger commands.
cat mdb_categories > mdb_doc
tmp="mdb_doc_tmp.$$"
trap 'rm -f ${tmp}' 0 1 2 3 15
info -f ./mercury_user_guide.info -o ${tmp} \
-n "Mercury debugger concepts"
../util/info_to_mdb concepts ${tmp} >> mdb_doc
# Document the declarative debugger.
info -f ./mercury_user_guide.info -o ${tmp} \
-n "Declarative debugging overview"
echo "document concepts 10 decl_debug" >> mdb_doc
sed 's/^ //' < ${tmp} | sed -n '6,1000s/^/ /p' >> mdb_doc
echo >> mdb_doc
info -f ./mercury_user_guide.info -o ${tmp} \
-n "Declarative debugging commands"
echo "The following commands are available from within the" \
"declarative debugger:" `./commands ${tmp}` | \
fold -w72 -s | sed "s/^/ /" >> mdb_doc
echo end >> mdb_doc
../util/info_to_mdb decl ${tmp} >> mdb_doc
debug_cmd_path="debug debugger"
for section in interactive forward backward browsing breakpoint \
i/o parameter help declarative misc exp developer
do
case ${section} in
interactive) category=queries ;;
i/o) category=io_tabling ;;
declarative) category=mdb_dd ;;
*) category=$section ;;
esac
info -f ./mercury_user_guide.info -o ${tmp} ${debug_cmd_path} ${section}
../util/info_to_mdb ${category} ${tmp} >> mdb_doc
done
mv mdb_doc ${tmp}
./squeeze < ${tmp} > mdb_doc