You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tcl.apache.org by mx...@apache.org on 2022/01/06 17:03:00 UTC

[tcl-rivet] 02/03: documenting new switch -emit of package form 2.2

This is an automated email from the ASF dual-hosted git repository.

mxmanghi pushed a commit to branch quattuor
in repository https://gitbox.apache.org/repos/asf/tcl-rivet.git

commit 99431ce54be647b144870a98f5257d723eacf99b
Author: Massimo Manghi <ma...@gmail.com>
AuthorDate: Sat Nov 6 17:48:26 2021 +0100

    documenting new switch -emit of package form 2.2
---
 ChangeLog                      |  2 +-
 configure.ac                   |  9 ++++++++-
 doc/xml/form.xml               | 18 ++++++++++++++++--
 rivet/packages/form/form.tcl   |  2 --
 rivet/packages/form/form2.tcl  | 35 ++++++++++++++++++++---------------
 rivet/packages/form/form22.tcl |  2 +-
 6 files changed, 46 insertions(+), 22 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index a357f0d..f6cb72f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -2,7 +2,7 @@
 	* configure.ac: changing obsolete macro AC_PROG_LIBTOOL into LT_INIT
 
 2021-11-06 Massimo Manghi <mx...@apache.org>
-	* configure.ac: remove duplicated call of macro AM_INIT_AUTOMAKE. Add macro AC_CONFIG_SRCDIR
+	* configure.ac: remove duplicated call of macro AM_AUTOMAKE_INIT. Add macro AC_CONFIG_SRCDIR
 	* rivet/packages/form*.tcl: Update copyright lines, removed old svn symbols
 	* doc/xml/form.xml: documenting new switch -emit 
 
diff --git a/configure.ac b/configure.ac
index 600669b..e62fa51 100644
--- a/configure.ac
+++ b/configure.ac
@@ -29,7 +29,6 @@ TEA_INIT([3.9])
 CONFIGURE_CMD="$0 $*"
 
 AC_CONFIG_AUX_DIR(tclconfig)
-AM_INIT_AUTOMAKE
 AC_CONFIG_HEADERS([config.h])
 AC_CONFIG_MACRO_DIR([m4])
 
@@ -56,6 +55,14 @@ AX_PREFIX_CONFIG_H([rivet_config.h],[rivet])
 AC_DISABLE_STATIC
 AM_INIT_AUTOMAKE([foreign subdir-objects])
 
+# establishing a landmark in the directory hierarchy as per 
+# autotools design. This is what AC_CONFIG_SRCDIR is meant to do
+# I arbitrarily choose src/rivet.h as landmark, moving this file
+# to a different directory or deleting it implies this line has to
+# change
+
+AC_CONFIG_SRCDIR([src/rivet.h])
+
 #--------------------------------------------------------------------
 # Load the tclConfig.sh file
 #--------------------------------------------------------------------
diff --git a/doc/xml/form.xml b/doc/xml/form.xml
index 1bd5237..a0d25e4 100644
--- a/doc/xml/form.xml
+++ b/doc/xml/form.xml
@@ -42,7 +42,7 @@
 		</refsynopsisdiv>
 		<refsect1>
 			<para>
-	                        creates and returns a new Tcl command named <option><replaceable>form_name</replaceable></option>.
+				creates and returns a new Tcl command named <option><replaceable>form_name</replaceable></option>.
 			</para>
 			<refsect2>
 				<title>Options</title>
@@ -87,11 +87,25 @@
 								<command>load_response</command> command of Rivet when default 
 								values come from another form.
 							</para>
-						</listitem>	  		
+						</listitem>
 	  				</varlistentry>
 	  				<varlistentry>
 						<listitem>
 							<cmdsynopsis>
+								<arg choice="plain">-emit</arg>
+								<arg choice="opt"><replaceable>true(default)|false</replaceable></arg>
+							</cmdsynopsis>
+							<para>
+								a Tcl accepted representation of a Boolean value. Change a form object
+								instance behavior so that methods generating HTML form entries return
+								to the caller their output as string instead of directly sending it to stdout
+							</para>
+						</listitem>
+	  				</varlistentry>
+
+	  				<varlistentry>
+						<listitem>
+							<cmdsynopsis>
 								<arg choice="plain">-action</arg>
 								<arg choice="opt"><replaceable>URL</replaceable></arg>
 							</cmdsynopsis>
diff --git a/rivet/packages/form/form.tcl b/rivet/packages/form/form.tcl
index 3d34a1f..46e5a79 100644
--- a/rivet/packages/form/form.tcl
+++ b/rivet/packages/form/form.tcl
@@ -14,8 +14,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# $Id$
-#
 
 package require Itcl
 
diff --git a/rivet/packages/form/form2.tcl b/rivet/packages/form/form2.tcl
index aedeb71..d71c54e 100644
--- a/rivet/packages/form/form2.tcl
+++ b/rivet/packages/form/form2.tcl
@@ -1,18 +1,23 @@
-# form.tcl -- generate forms automatically.
-
-# Copyright 2002-2004 The Apache Software Foundation
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-
-#	http://www.apache.org/licenses/LICENSE-2.0
-
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# form2.tcl -- generate forms automatically.
+
+# Copyright 2002-2021 The Apache Software Foundation
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+#   http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 package require Itcl
 package provide form 2.1
diff --git a/rivet/packages/form/form22.tcl b/rivet/packages/form/form22.tcl
index eb472c8..3b91456 100644
--- a/rivet/packages/form/form22.tcl
+++ b/rivet/packages/form/form22.tcl
@@ -1,6 +1,6 @@
 # form.tcl -- generate forms automatically.
 
-# Copyright 2002-2004 The Apache Software Foundation
+# Copyright 2002-2021 The Apache Software Foundation
 
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@tcl.apache.org
For additional commands, e-mail: commits-help@tcl.apache.org