-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathUPGRADING
156 lines (125 loc) · 5.84 KB
/
UPGRADING
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
---------------------------------------------------
makefaq
Revision: 2.6
Rev Date: 22 Nov 2013
---------------------------------------------------
makefaq is a Python program that creates a Frequently Asked
Questions (FAQ) HTML page or text file from a specially
formatted text data file.
---------------------------------------------------
This file outlines issues about upgrading from previous
versions of makefaq.
============================================================
2.6
============================================================
No special notes about this release.
============================================================
2.5
============================================================
No special notes as this release is purely a warning bug fix.
============================================================
2.4
============================================================
No special notes as this release primarily provides a few
new features.
============================================================
2.3
============================================================
Note that if you were using the "-r" flag to use the older
single-line format, you now need to use "-r 1" to achieve
the same result. This is necessary because with the next
version that reads an XML file, "-r 2" will be used to read
the current file format.
By default, the HTML file now includes a link to a CSS
stylesheet (faq.css). If you do not want to use this file,
remove the relevant line from faqheader.html. Otherwise,
you may now change fonts in faq.css.
============================================================
2.2
============================================================
No special notes as this change is primarily a bug fix for
non-Linux platforms. Note that a Makefile is now provided to
ease installation.
============================================================
2.1
============================================================
No special notes as this change is primarily for a bug fix.
Note that a man page is now included as well. See INSTALL.
============================================================
2.0
============================================================
There is a MAJOR change to this version in that the data file
format has now moved to an XML-ish format that allows multi-
line entries for each question/answer pair. Your previous
data file WILL NOT WORK with the default settings. If you
wish to use your existing data file in the old format, you
need to add the '-r' option to makefaq (for "revert" to old
file format), as in the example:
./makefaq.py -r
You can use any other standard command-line options (see
README) in conjunction with '-r'.
The program also now looks for the LANG environment variable
and, if it exists, attempts to use the variable contents as
the locale for setting the language to be used in the FAQ.
What this does is to use the native language format for the
time, and to use the appropriate text for "FAQ Revised" and
"Table of Contents".
If you do NOT want it to use the LANG variable and want it
to use a specific locale, there is now a '-L' (upper case)
option that allows you to set the locale. For instance, if
you want the FAQ to be generated using US English settings,
but your own LANG variable is set to something else, you
could use:
./makefaq.py -L 'en_US'
along with any other command-line options.
Note that at the time of this writing, any locale should
generate the appropriate time, however there are only
three settings for the text strings: en_US, fr_FR and
de_DE. All other locales will have the appropriate time
string, but will have the en_US text strings.
Additional strings can be added to the makefaq code.
============================================================
0.5
============================================================
The only change in this version is that there is now a '-d'
command-line option that allows you to change the delimiter
to be something other than the default pipe ('|') character.
Additionally, text has been changed in the sample header and
footer files to better inform people about where they need
to be making changes. This is so that hopefully people will
not just leave the standard files in place with my email
address there.
============================================================
0.4
============================================================
There is a major change regarding the data file in
version 0.4. The code was corrected so that categories
are output to the HTML/text FAQ file *in the order in
which they appear* in the data file (faq.dat by default).
If you experimented around with placement of categories
in the data file to get the results in the order you wanted,
you might now need to reorder the items in the data file
to get them in the order you want.
Note that you do not need to move *all* the items from
a category around inside of the data file. The categories
are added in the order they are found. One approach might
be to begin the data file with a line for each of the
categories you anticipate having. That will get them in
the order you desire. After that, subsequent lines can be
in any order.
Also note that there is now a "-s" command-line option to
sort the categories in alphabetical order. This overrides
the order in which the categories appear in the data file.
============================================================
0.3
============================================================
There are several major changes to the way the program
operates from 0.2:
1. THE DEFAULT DATA FILE NAME HAS CHANGED to 'faq.dat"
from the previous 'faq.txt'
2. The default behavior is to write the text out to
a file called 'faq.html' rather than to stdout
as it did in 0.2.
3. There are now command-line options.
4. There are now multiple "configurations" possible.
============================================================