Index: trunk/doc/user/09_appendix/action_src/layer.html
===================================================================
--- trunk/doc/user/09_appendix/action_src/layer.html	(nonexistent)
+++ trunk/doc/user/09_appendix/action_src/layer.html	(revision 543)
@@ -0,0 +1,18 @@
+Change a layer property or layer ordering, depending on the argument:
+<p>
+Up or down moves the layer one slot up or down in layer ordering. Top or bottom
+moves the layer to the top or bottom in layer ordering. Layers are rendered
+from bottom to top: layers higher on the list will render over layers lower
+on the list. This matters especially if appearance/layer_alpha is 1 and
+layers are solid with no translucencly.
+<p>
+Del removes the currently selected layer.
+<p>
+getidx  returns the index of the currently selected layer as an integer;
+getlen returns the number of layers as an integer. These are useful for
+user scripting.
+<p>
+setcolor and rename changes the color or name of the currently selected layer
+(new color or name supplied as a second argument).
+<p>
+all-visible and all-invisible changes visibility of all layers. 
\ No newline at end of file
Index: trunk/doc/user/09_appendix/src/Makefile
===================================================================
--- trunk/doc/user/09_appendix/src/Makefile	(nonexistent)
+++ trunk/doc/user/09_appendix/src/Makefile	(revision 543)
@@ -0,0 +1,26 @@
+CAMVRND = ../../../../src/camv-rnd
+CLEANFILES=../action_details.html ../action_reference.html ../formats.html ../dialogs.html
+
+all: $(CLEANFILES)
+
+../action_details.html: ./action_compiler.sh ../action_src/*.html librnd_acts
+	./action_compiler.sh ../action_src/*.html LIBRND librnd_acts/*.html > ../action_details.html
+
+../action_reference.html : ./dump_actions_to_html.sh $(CAMVRND) ../action_details.html librnd_acts
+	./dump_actions_to_html.sh > ../action_reference.html
+
+librnd_acts: FORCE
+	svn checkout svn://svn.repo.hu/librnd/trunk/doc/action librnd_acts
+
+
+../formats.html: gen_formats.sh ../../../../src_plugins/io_*/*.pup ../../../../src_plugins/import_*/*.pup ../../../../src_plugins/export_*/*.pup
+	./gen_formats.sh > ../formats.html
+
+../dialogs.html: $(CAMVRND) ./gen_dialogs.sh ./dialog_extra.awk
+	./gen_dialogs.sh > ../dialogs.html
+
+FORCE:
+
+clean:  
+	rm $(CLEANFILES)
+	-rm -rf librnd_acts
Index: trunk/doc/user/09_appendix/src/action_compiler.sh
===================================================================
--- trunk/doc/user/09_appendix/src/action_compiler.sh	(nonexistent)
+++ trunk/doc/user/09_appendix/src/action_compiler.sh	(revision 543)
@@ -0,0 +1,180 @@
+#!/bin/sh
+
+SEP="<@@@@>"
+SEPH="<@@H@@>"
+
+compile()
+{
+	awk -v "SEP=$SEP" -v "SEPH=$SEPH" '
+	BEGIN {
+		q="\""
+		SEP="^" SEP
+		SEPH="^" SEPH
+	}
+
+	function strip(s) {
+		sub("^[ \t]*", "", s)
+		sub("[ \t]*$", "", s)
+		return s
+	}
+
+	function read_tag(tag,    tmp1,tmp2) {
+		getline tmp1
+		getline tmp2
+		if (tmp2 ~ "</" tag)
+			return tmp1
+		print "Error: expected closing tag " tag " in line " NR " of " current > "/dev/stderr"
+		exit(1)
+	}
+
+	function notav(s) {
+		if (s == "") return "n/a"
+		return s
+	}
+
+	function end_act()
+	{
+		if (current != "")
+			print "</dd></dl>"
+		currrent = ""
+	}
+
+	($0 ~ SEP) {
+		end_act()
+		action = ""
+		$1=""
+		current=tolower(strip($0))
+		sub("^.*/", "", current)
+		sub(".html$", "", current)
+
+		if (current in ANAME)
+			aname = ANAME[current]
+		else
+			aname = current
+
+		print ""
+		print "<h2 id=" q current q ">" aname "</h2>"
+		print "<dl><dd>"
+		print "<p>"
+		print "<table border=0 cellspacing=10 class=actsum>"
+		print "<tr><th align=right class=actsum>Syntax summary:<td align=left class=actsum>" notav(SYNTAX[current])
+		print "<tr><th align=right class=actsum>Help text:<td align=left class=actsum>"      notav(HELP[current])
+		print "<tr><th align=right class=actsum>Registered&nbsp;by:<td align=left class=actsum>"  notav(COOKIE[current])
+		print "</table>"
+		print "<p>"
+		next
+	}
+
+
+	($0 ~ SEPH) {
+		end_act()
+		action = ""
+		$1=""
+		print "<h1>" $0 "</h1>"
+		aname=""
+		next
+	}
+
+	(current == "") && (/^A/) {
+		# reading the action list: new action
+		action=strip($0)
+		sub("^A", "", action)
+		aname= action
+		action = tolower(action)
+# avoid saving duplicates at the main action node
+		if (action in SEEN)
+			action = action "_dup"
+		else
+			ANAME[action] = aname
+		SEEN[action] = 1
+		next
+	}
+
+
+	(current == "") && (/^D/) {
+		# reading the action list: help line
+		tmp = $0
+		sub("^D", "", tmp)
+		HELP[action]=HELP[action] "\n" tmp
+		next
+	}
+
+	(current == "") && (/^S/) {
+		# reading the action list: syntax line
+		tmp = $0
+		sub("^S", "", tmp)
+		SYNTAX[action]=SYNTAX[action] "\n" tmp
+		next
+	}
+
+	(current == "") && (/^C/) {
+		# reading the action list: cookie line
+		tmp = $0
+		sub("^C", "", tmp)
+		COOKIE[action]=COOKIE[action] "\n" tmp
+		next
+	}
+
+	/^<arg>/ {
+		arg = read_tag("arg")
+		print "<i>" arg "</i>"
+		next
+	}
+
+	/^<example>/ {
+		ex = read_tag("example")
+		print "Example:", ex, "<br>"
+		next
+	}
+
+	/^<act>/ {
+		act = tolower(read_tag("act"))
+		print "<a href=" q "#" act q ">" act "</a>"
+		next
+	}
+
+	{
+		print
+	}
+
+	END {
+		end_act()
+	}
+	'
+}
+
+echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!-- AUTOGENERATED FILE, DO NOT EDIT ; generator is action_compiler.sh (run make) -->
+<html>
+<head>
+	<title> camv-rnd user manual - action details </title>
+	<meta http-equiv="Content-Type" content="text/html;charset=us-ascii">
+	<link rel="stylesheet" type="text/css" href=" ../default.css">
+</head>
+<body>
+<h1> camv-rnd actions (details) </h1>
+'
+
+(
+	(
+		cd ../../../../src
+		./camv-rnd --dump-actions 2>/dev/null
+	)
+	for fn in "$@"
+	do
+		if test "$fn" = "LIBRND"
+		then
+			echo ""
+			echo "$SEPH librnd actions (common to Ringdove)"
+		else
+			echo ""
+			echo "$SEP $fn"
+			tr "\n\r\t" "   " < $fn | sed "s@<@\n<@g;s@>@>\n@g;"
+		fi
+	done
+) |  compile
+
+echo '
+</body>
+</html>
+'

Property changes on: trunk/doc/user/09_appendix/src/action_compiler.sh
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*
\ No newline at end of property
Index: trunk/doc/user/09_appendix/src/dialog_extra.awk
===================================================================
--- trunk/doc/user/09_appendix/src/dialog_extra.awk	(nonexistent)
+++ trunk/doc/user/09_appendix/src/dialog_extra.awk	(revision 543)
@@ -0,0 +1,6 @@
+# extra information about dialog boxes; anything that can not be extracte
+# automatically from the code. Arrays indexed by id or source.
+BEGIN {
+	ACTION["brave"] = "brave()"
+#	ACTION["progress"] = "n/a"; COMMENT["progress"] = "no action API yet (but it is planned)"
+}
Index: trunk/doc/user/09_appendix/src/dump_actions_to_html.sh
===================================================================
--- trunk/doc/user/09_appendix/src/dump_actions_to_html.sh	(nonexistent)
+++ trunk/doc/user/09_appendix/src/dump_actions_to_html.sh	(revision 543)
@@ -0,0 +1,121 @@
+#!/bin/sh
+
+# collates the camv-rnd action table into a html doc page
+
+asrc="../action_src"
+lsrc="librnd_acts"
+
+cd ../../../../src
+camv_rnd_ver=`./camv-rnd --version`
+camv_rnd_rev=`svn info ^/ | awk '/Revision:/ {
+	print $0
+	got_rev=1
+	exit
+	}
+	END {
+		if (!got_rev)
+		print "Rev unknown"
+	}
+	'`
+cd ../doc/user/09_appendix/src
+
+echo 	"<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">
+<html>
+<head>
+<title> camv-rnd user manual </title>
+<meta http-equiv=\"Content-Type\" content=\"text/html;charset=us-ascii\">
+<link rel=\"stylesheet\" type=\"text/css\" href=\" ../default.css\">
+</head>
+<body>
+<p>
+<h1> camv-rnd User Manual: Appendix </h1>
+<p>
+<h2> Action Reference</h2>
+<table border=1>"
+echo "<caption>\n" "<b>"
+echo $camv_rnd_ver ", " $camv_rnd_rev
+echo "</b>"
+echo  "<th> Action <th> Description <th> Syntax <th> Plugin"
+(
+	cd ../../../../src
+	./camv-rnd --dump-actions 2>/dev/null
+) | awk '
+
+function flush_sd()
+{
+		if ( a != "" ||  s != "" || d != "" ) {
+			sub("^<br>", "", a)
+			sub("^<br>", "", d)
+			sub("^<br>", "", s)
+			sub("^<br>", "", c)
+			print  "<tr><act>" a "</act>" "<td>" d "</td>" "<td>" s "</td>" "<td>" c "</td>"
+			}
+		
+	a=""
+	s=""
+	d=""
+	c=""
+}
+
+
+/^A/ {
+	flush_sd()
+	sub("^A", "", $0)
+	a = a "<br>" $0
+	next
+}
+
+/^D/ {
+	sub("^D", "", $0)
+	d = d "<br>" $0
+	next
+}
+
+/^S/ {
+	sub("^S", "", $0)
+	s = s "<br>" $0
+	next
+}
+
+/^C/ {
+	sub("^C", "", $0)
+	c = c "<br>" $0
+	next
+}
+
+' | sort -fu | awk -v "asrc=$asrc" -v "lsrc=$lsrc" '
+# insert links around actions where applicable
+	BEGIN {
+		q = "\""
+	}
+	/<act>/ {
+		pre = $0
+		sub("<act>.*", "", pre)
+		post = $0
+		sub(".*</act>", "", post)
+		act = $0
+		sub(".*<act>", "", act)
+		sub("</act>.*", "", act)
+		loact = tolower(act)
+		fn = asrc "/" loact ".html"
+		lfn = lsrc "/" loact ".html"
+		if ((getline < fn) == 1)
+			print pre "<td><a href=" q "action_details.html#" loact q ">" act "</a></td>" post
+		else if ((getline < lfn) == 1)
+			print pre "<td><a href=" q "action_details.html#" loact q ">" act "</a> <sup><a href=\"#ringdove\">(RND)</a></sup></td>" post
+		else
+			print pre "<td>" act "</td>" post
+		close(fn)
+		close(lfn)
+		next
+	}
+
+	{ print $0 }
+	
+	END {
+		print "</table>"
+		print "<p id=\"ringdove\">RND: this action comes from librnd and is common to all ringdove applications."
+		print "</body>"
+		print "</html>"
+	}
+'

Property changes on: trunk/doc/user/09_appendix/src/dump_actions_to_html.sh
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*
\ No newline at end of property
Index: trunk/doc/user/09_appendix/src/gen_dialogs.sh
===================================================================
--- trunk/doc/user/09_appendix/src/gen_dialogs.sh	(nonexistent)
+++ trunk/doc/user/09_appendix/src/gen_dialogs.sh	(revision 543)
@@ -0,0 +1,91 @@
+#!/bin/sh
+
+trunk=../../../..
+
+# exceptions
+dlgtbl='
+BEGIN {
+	# if source filename is the index and value regex-matches either id or name
+	# just ignore that line
+	IGNORE["src_plugins/dialogs/dlg_view.c"] = "<dyn>"
+	IGNORE["src_plugins/dialogs/act_dad.c"] = "<dyn>"
+}
+'
+
+echo '
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+	<title> camv-rnd - list of file formats </title>
+	<meta http-equiv="Content-Type" content="text/html;charset=us-ascii">
+	<link rel="stylesheet" type="text/css" href="../default.css">
+</head>
+<body>
+
+<h1> camv-rnd User Manual: Appendix </h1>
+<p>
+<h2> List of GUI dialog boxes </h2>
+<table border=1 cellspacing=0>
+<tr>
+	<th> ID
+	<th> dialog box name
+	<th> action
+	<th> source
+	<th> comments
+'
+
+$trunk/util/devhelpers/list_dialogs.sh | awk -F "[\t]" '
+function orna(s)
+{
+	if ((s == "") || (s == "<dyn>")) return "n/a"
+	return s
+}
+
+'"$dlgtbl"'
+'"`cat dialog_extra.awk`"'
+
+function out(id, name, src, action, comment     ,acturl1,acturl2,fn,tmp) {
+	if (action == "") {
+		if (id in ACTION) action = ACTION[id]
+		else if (src in ACTION) action = ACTION[src]
+	}
+
+	if (action != "") {
+		acturl1 = action
+		sub("[(].*", "", acturl1)
+		fn = "../action_src/" acturl1 ".html"
+		if ((getline tmp < fn) == 1) {
+			acturl1 = "<a href=\"action_details.html#" tolower(acturl1) "\">"
+			acturl2 = "</a>"
+		}
+		else {
+			acturl1 = ""
+			acturl2 = ""
+		}
+		close(fn)
+	}
+
+	if (comment == "") {
+		if (id in COMMENT) comment = COMMENT[id]
+		else if (src in COMMENT) comment = COMMENT[src]
+		else comment = "&nbsp;"
+	}
+
+	print "<tr><td>" orna(id) "<td>" orna(name) "<td>" acturl1 orna(action) acturl2 "<td>" src "<td>" comment
+}
+
+{
+	id=$1
+	name=$2
+	src=$3
+	if ((src in IGNORE) && ((name ~ IGNORE[src]) || (id ~ IGNORE[src])))
+		next
+	out(id, name, src)
+}
+'
+
+echo '
+</table>
+</body>
+</html>
+'

Property changes on: trunk/doc/user/09_appendix/src/gen_dialogs.sh
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*
\ No newline at end of property
Index: trunk/doc/user/09_appendix/src/gen_formats.sh
===================================================================
--- trunk/doc/user/09_appendix/src/gen_formats.sh	(nonexistent)
+++ trunk/doc/user/09_appendix/src/gen_formats.sh	(revision 543)
@@ -0,0 +1,104 @@
+#!/bin/sh
+
+PLUGINS=../../../../src_plugins
+
+echo '
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+	<title> camv-rnd - list of file formats </title>
+	<meta http-equiv="Content-Type" content="text/html;charset=us-ascii">
+	<link rel="stylesheet" type="text/css" href="../default.css">
+</head>
+<body>
+
+<h1> camv-rnd User Manual: Appendix </h1>
+<p>
+<h2> File format support </h2>
+
+<table border=1>
+	<tr>
+	<th> plugin <th> native <th> state <th> reads formats <th> writes formats
+'
+
+files_io=`ls $PLUGINS/io_*/*.pup | sort`
+files_e=`ls $PLUGINS/export_*/*.pup | sort`
+files_i=`ls $PLUGINS/import_*/*.pup | sort`
+
+for n in $files_io $files_i $files_e
+do
+	bn=`basename $n`
+	bn=${bn%%.pup}
+	sed '
+		/^[$]fmt[-]/ { s@^@'$bn' @; p }
+		/^[$]state/ { s@^@'$bn' @; p }
+		{ d }
+	' $n
+done | awk '
+	BEGIN {
+		plgs = 0
+	}
+	{
+		if ($1 != last) {
+			PLG[plgs] = $1
+			last = $1
+			plgs++
+		}
+		p=$1
+		f=$2
+		text=$0
+		sub("^[^ \t]+[ \t]+[^ \t]+[ \t]+", "", text)
+		DATA[p, f] = DATA[p, f] SUBSEP text
+	}
+
+	function col(mask    ,n,v,i,A) {
+		print " <td>"
+		v = split(DATA[mask], A, "[" SUBSEP "]")
+		if (v == 0) {
+			print "n/a"
+			return
+		}
+		i = 0;
+		for(n = 1; n <= v; n++) {
+			if (A[n] == "")
+				continue;
+			if (i)
+				print "  <br>"
+			print "  " A[n]
+			i++
+		}
+	}
+
+	function strip(s)
+	{
+		gsub("[" SUBSEP "]", " ", s)
+		sub("^[ \t]*", "", s)
+		sub("[ \t]*$", "", s)
+		return s
+	}
+
+	function row(plg) {
+		print "<tr><th>" plg
+		print "<td>" strip(DATA[plg, "$fmt-native"])
+		print "<td>" strip(DATA[plg, "$state"])
+		col(plg SUBSEP "$fmt-feature-r")
+		col(plg SUBSEP "$fmt-feature-w")
+	}
+
+	END {
+		for(p=0; p < plgs; p++)
+			if (DATA[PLG[p], "$fmt-native"] ~ "yes")
+				row(PLG[p])
+
+		for(p=0; p < plgs; p++)
+			if (!(DATA[PLG[p], "$fmt-native"] ~ "yes"))
+				row(PLG[p])
+	}
+'
+
+
+echo '
+</table>
+</body>
+</html>
+'

Property changes on: trunk/doc/user/09_appendix/src/gen_formats.sh
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*
\ No newline at end of property