Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6146f8df authored by Paul E. McKenney's avatar Paul E. McKenney
Browse files

documentation: Get rid of duplicate .htmlx file 



This commit uses colors to obscure the quick-quiz answers, thus getting
rid of the .htmlx file.  Use your mouse to select the answer in order
to see the text.  Alternatively, use your favorite scripting language
to remove all occurences of "<font color="ffffff">" from the file.

Reported-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
Signed-off-by: default avatarPaul E. McKenney <paulmck@linux.vnet.ibm.com>
parent 11a65df5

Documentation/RCU/Design/Requirements/Requirements.html

+428 −461

File changed.

Preview size limit exceeded, changes collapsed.

Documentation/RCU/Design/Requirements/Requirements.htmlx

deleted100644 → 0
+0 −2872

File deleted.

Preview size limit exceeded, changes collapsed.

Documentation/RCU/Design/htmlqqz.sh

deleted100755 → 0
+0 −108
Original line number Original line Diff line number Diff line 
#!/bin/sh

#

# Usage: sh htmlqqz.sh file

#

# Extracts and converts quick quizzes in a proto-HTML document file.htmlx.

# Commands, all of which must be on a line by themselves:

#

#	"<p>@@QQ@@": Start of a quick quiz.

#	"<p>@@QQA@@": Start of a quick-quiz answer.

#	"<p>@@QQE@@": End of a quick-quiz answer, and thus of the quick quiz.

#	"<p>@@QQAL@@": Place to put quick-quiz answer list.

#

# Places the result in file.html.

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

# GNU General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, you can access it online at

# http://www.gnu.org/licenses/gpl-2.0.html.

#

# Copyright (c) 2013 Paul E. McKenney, IBM Corporation.



fn=$1

if test ! -r $fn.htmlx

then

	echo "Error: $fn.htmlx unreadable."

	exit 1

fi



echo "<!-- DO NOT HAND EDIT. -->" > $fn.html

echo "<!-- Instead, edit $fn.htmlx and run 'sh htmlqqz.sh $fn' -->" >> $fn.html

awk < $fn.htmlx >> $fn.html '



state == "" && $1 != "<p>@@QQ@@" && $1 != "<p>@@QQAL@@" {

	print $0;

	if ($0 ~ /^<p>@@QQ/)

		print "Bad Quick Quiz command: " NR " (expected <p>@@QQ@@ or <p>@@QQAL@@)." > "/dev/stderr"

	next;

}



state == "" && $1 == "<p>@@QQ@@" {

	qqn++;

	qqlineno = NR;

	haveqq = 1;

	state = "qq";

	print "<p><a name=\"Quick Quiz " qqn "\"><b>Quick Quiz " qqn "</b>:</a>"

	next;

}



state == "qq" && $1 != "<p>@@QQA@@" {

	qq[qqn] = qq[qqn] $0 "\n";

	print $0

	if ($0 ~ /^<p>@@QQ/)

		print "Bad Quick Quiz command: " NR ". (expected <p>@@QQA@@)" > "/dev/stderr"

	next;

}



state == "qq" && $1 == "<p>@@QQA@@" {

	state = "qqa";

	print "<br><a href=\"#qq" qqn "answer\">Answer</a>"

	next;

}



state == "qqa" && $1 != "<p>@@QQE@@" {

	qqa[qqn] = qqa[qqn] $0 "\n";

	if ($0 ~ /^<p>@@QQ/)

		print "Bad Quick Quiz command: " NR " (expected <p>@@QQE@@)." > "/dev/stderr"

	next;

}



state == "qqa" && $1 == "<p>@@QQE@@" {

	state = "";

	next;

}



state == "" && $1 == "<p>@@QQAL@@" {

	haveqq = "";

	print "<h3><a name=\"Answers to Quick Quizzes\">"

	print "Answers to Quick Quizzes</a></h3>"

	print "";

	for (i = 1; i <= qqn; i++) {

		print "<a name=\"qq" i "answer\"></a>"

		print "<p><b>Quick Quiz " i "</b>:"

		print qq[i];

		print "";

		print "</p><p><b>Answer</b>:"

		print qqa[i];

		print "";

		print "</p><p><a href=\"#Quick%20Quiz%20" i "\"><b>Back to Quick Quiz " i "</b>.</a>"

		print "";

	}

	next;

}



END {

	if (state != "")

		print "Unterminated Quick Quiz: " qqlineno "." > "/dev/stderr"

	else if (haveqq)

		print "Missing \"<p>@@QQAL@@\", no Quick Quiz." > "/dev/stderr"

}'