Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 213 lines (169 sloc) 9.06 kb
d8fbd6e @racke restrict documentation added, but it is ignored :-(
racke authored
1 Bugs:
91241ba @docelic * Improved See Also linking: much less items are now linked automatic…
docelic authored
2 - work on bin/mkreport
bf6d498 @docelic Remove the recently added code for [restrict]s and replace
docelic authored
3 - search doc se nevidi jer je search neki actionmap
55227f0 @docelic * In HTML output, make the filenames in source section clickable.
docelic authored
4 - provide static files for download, describe keys like alt+n
7e69fd7 @docelic * Larger commit moving us towards "online docs"
docelic authored
5 - u CVS listi, da je fajl nejm link na CVS
d8fbd6e @racke restrict documentation added, but it is ignored :-(
racke authored
6 - documentation for bounce and restrict is ignored
ad4383f @docelic * Small improvements to bin/ scripts
docelic authored
7 - some small error in glossary/pragma at the bottom, [tag pragma]0[/tag]
cdc1be8 @docelic * Discover core tags from Interpolate.pm, so they show up in list of
docelic authored
8 - see if the files we parse in bin/stattree in block (like parseVendConfig, parseVendInterpolate) allow some stuff to go unaccounted for mkreport
9 - with tags from Interpolate.pm, context for systemtag is not always 'whole file', but can be x-y as well
3877fc5 @docelic * For HTML output:
docelic authored
10 - dal autogen preskoci kontekst koji je prazan? i zasto uopce unkondicionalno
11 ekspandira @$ctx ako moze da nema konteksta?
cdc1be8 @docelic * Discover core tags from Interpolate.pm, so they show up in list of
docelic authored
12
d8fbd6e @racke restrict documentation added, but it is ignored :-(
racke authored
13
f4b2f5b @docelic docbook/literals.ent: Added entity ≥ - "glossary entry"
docelic authored
14 - order counter, Session->{mv_order_number}, cronjob -0001, or file da-te.counter, or session_id.time
b8bc221 @docelic * Updates. Too bad I'm idle lately. My PC machines went broken, and
docelic authored
15 - in iccattut, s/item-field/item-param/ at least on some places.
16 - Make xmldocs tarball in ftp autoupdated
17 - Change -latest to version number in tarball download
a409c1d @docelic - TODO: Note about fixing/updating AdminUser docs
docelic authored
18 - fix/update AdminUser docs
e2433a3 @racke added note about directive aliases
racke authored
19 - aliases like DataDir/DefaultTables are not documented
ec014c1 @docelic - TODO items
docelic authored
20 - unit testing
9ac97f5 @docelic - files/*: xhtml compliance
docelic authored
21 - remove NEW from <meta>
a013646 @docelic - slight adjustments to existing stuff
docelic authored
22 - In tags, make XSLT code print position number besides "Yes" word in
23 positional parameters for tags
24 - add search box to guides/index.xml
77653a8 @docelic - TODO: remove some resolved tasks
docelic authored
25 - make See Also only go two or three levels recursively. Currently we do it
26 until the "chain" ends, which results in having many unrelated options
27 listed under See Also.
f4b2f5b @docelic docbook/literals.ent: Added entity &GE; - "glossary entry"
docelic authored
28 - in search.xml replace mv_ listitems with sections so they're listed in TOC
69a0c32 @docelic * Same as previous commit, synopsis line simplification, wording impr…
docelic authored
29 - note in configuration glossentry to use '' to skip values
267221c @docelic * Went over the rest of configuration directives, polished the text,
docelic authored
30 - Check ConfigDatabase and DirectiveDatabase. Is description correct? One seems to be wrong
31 - preprocessor directives in configuration ?
da86c51 @docelic - Added a few todo items and small fixes here and there
docelic authored
32 - FAQ should be desintegrated to other places
33 - what doesn't racke like with WHATSNEW
34 - replace itemlists with sections or tables
35 - component tag has wrong source context
36 Entities to create:
37 - \0 null char
38 - table/column/key should be defined in docbook/literals.ent as ROW_TABLE...
39 - DEFAULT_JOINER_N for \n
40 - SAFE_DATA
bf62651 @docelic * Described link program in glossary
docelic authored
41
c52871f @docelic Some new items, good stuff.
docelic authored
42 Outstanding:
43 =======
4946375 @docelic - An easy commit to break the summer silence.
docelic authored
44 - Can *_page pragmas take ITL and not just subroutine names?
d458e36 @docelic - Documented few filters
docelic authored
45 - See that if 'crypt' is put in see also, all symbols of that name appear
46 in see also line and their type is distinguished visually.
fb2f4cb @docelic - one more glossary entry
docelic authored
47 - TAXAREA is not discovered in source by bin/stattree
f176a7c @docelic The usual accompanying improvements
docelic authored
48 - Make MapRoutined source contexts have Line: x-y instead of Lines: z header.
fb2f4cb @docelic - one more glossary entry
docelic authored
49 - recognize situations where contexts overlap, but in a special way that
50 first example does not see the other, but the other sees the first becase
51 of 10 lines of pre-context. (example is IMAGE_MOGRIFY refentry). In those
52 cases, resize area of the context report so that it appears as one
f176a7c @docelic The usual accompanying improvements
docelic authored
53 - With confs, also include source context where it is being used
54 - In vars.html, include line if it appears in variable.txt
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
55 - match style (no starting verb or all starting verbs) in all Example titles
56 - check if all Default fields are properly formated (<literal> or none)
d2c6eee @docelic - Makefile: remove dependence on bin/stattree
docelic authored
57 - make regexp matching better, to properly scan parse_subroutine(); (gets
58 confused by { { in a substitution)
59 - in refs, replace "database" with "database_name", that kind of things
60 - import my hand-made test from /var/lib/.../pages/* to appropriate
61 ref pages as online examples
62 - At least in filters, <<EOR messes up the thing, only < is printed and stops
1429304 @racke added shortcoming with missing configuration links
racke authored
63 - &conf-RobotLimit; doesn't link to RobotLimit configuration page
d458e36 @docelic - Documented few filters
docelic authored
64
65 Coding:
e680b7a @docelic - bin/stattree:
docelic authored
66 - script to [un]comment debug lines!!
238f9d5 @docelic - Added Interchange FAQ document ( guides/faq.xml ).
docelic authored
67 - use Interchange.pm to make an Interchange shell (External.pm!)
68 - finish ML stats <-- MAILPOND on ocelic2!
554f9d4 @docelic - TODO: remove stuff that's been handled over the time, or doesn't fit
docelic authored
69 - script to manipulate file headers
cb13dd7 @docelic - TODO: Updated TODO entry
docelic authored
70
dc2ec38 @docelic - Makefile:
docelic authored
71 Mid-term:
2767140 @docelic - Makefile: remove ordercheckout document which I'll decompose to dif…
docelic authored
72 - List of mv_s, descriptions and shortcuts
dc2ec38 @docelic - Makefile:
docelic authored
73 - for "online" docs, also provide a form where users can add comments or
74 ask for clarification. (this could be done with either pure IC (forum?), or
7b35729 @docelic - Makefile: added support for howtos
docelic authored
75 XML forms capability, or wiki?)..
16b446f @docelic - Makefile:
docelic authored
76 - Generate leaf nodes (put bin/mkreport back in action)
d458e36 @docelic - Documented few filters
docelic authored
77 - If filter returns Vend::xxx::something(), include that function in context
78 reports, and try to determine the "Uses" field (which also needs to be
79 added to filter refentry template or something)
e8f63ad @docelic - bin/stattree:
docelic authored
80
81 Tags:
81e9a5e @docelic refs/area:
docelic authored
82 aliases
83 tag call / perl call / mvasp
84 container
85 has subtags
86 nests
e8f63ad @docelic - bin/stattree:
docelic authored
87
e680b7a @docelic - bin/stattree:
docelic authored
88
89
e976408 @docelic Evening commit
docelic authored
90 Ideas:
e680b7a @docelic - bin/stattree:
docelic authored
91 - In db_columns: add exlude_columns= parameter?
e976408 @docelic Evening commit
docelic authored
92 - New docs:
93 - promotional
94 - new developer howto
95 - filenames in Source contexts should also be clickable. this is longterm
96 because it'll involve perltidy and other stuff I have in mind ...
c52871f @docelic Some new items, good stuff.
docelic authored
97 - CVS page: http://www.icdevgroup.org/i/dev/cvs.html?id=auxbUMnz
98 Make a tutorial : IC from CVS, Catalog in SVN, replicated setup online
99 and locally
100 - How to deal with Safe
101 Programming guidelines doc - integrate with programming style. Advise
102 programmers of choices to make in order to make their code play well with
103 IC - for example, if they want to have a field in the DB for images,
104 advise them to name the column 'image' because other tags (they might or
105 might not later use) take that as default value. etc...
106 guide on setting complete IC environment
107 explain version naming.. stable/unstable and how 5.3.0 implies next stable
108 Documentation on how to create replicated catalog online and at your
109 desktop machine for ultimate convenience.
5f3f31f @docelic - Some new stuff, some placeholders, some updates/fixes to existing f…
docelic authored
110 - Whereever we count things, (like, valid Locale keys are decimal_point,
111 mon_grouping, price_picture,n_cs_precedes etc.) make that information
112 derived by scripting in stattree, not manually counting
e976408 @docelic Evening commit
docelic authored
113
e680b7a @docelic - bin/stattree:
docelic authored
114
e976408 @docelic Evening commit
docelic authored
115 Notes:
116 - say that code is colorful collection of time and people, so docs try to fill
e680b7a @docelic - bin/stattree:
docelic authored
117 the gap.
e976408 @docelic Evening commit
docelic authored
118 - say that even though sometimes the code looks ugly/unreadable, check 3 times before thinking it's a bug
119 - ** Dan Browning: clustering howto, tuning tips (by Mike),
120 - jedit + IC colorization, commit-to-live script,
121 - Racke: performance docs NEEDED, clustering my mike needs funding or he
122 won't do it. CVS howto is browning.
f176a7c @docelic The usual accompanying improvements
docelic authored
123
124
e976408 @docelic Evening commit
docelic authored
125 - "In times of universal deceit, telling the truth becomes
126 a revolutionary act." -- George Orwell.
127 - For a successful technology, reality must take precedence over public
128 relations, for Nature cannot be fooled. -- Dick Feynman
129
130
131 Misc:
132 - Mike We are short on chiefs and heavy on Indians here
133
5d5c2a2 @docelic - bin/stattree:
docelic authored
134
135
8a8fb40 @docelic As usual, I am wonderful ;-) Here's the reason this time:
docelic authored
136 - In iccattut:
5d5c2a2 @docelic - bin/stattree:
docelic authored
137 - Check if redhat/tarball paths are correct
138 - explain syntax accepted in profile files
139 - Fix ImageDir and include one picture for example
140 - <Racke>I name three things that IC users often didn't acknowledge:
141 namespaces (CGI, Values, Scratch)
142 parsing order ([L], variables, lists) - interpolation
143 inventing syntax doesn't buy you anything
144 IC is _not_ a programming language
145 - how to delete item from cart in all possible ways
146 - give examples for the tasks in 'do yourself' section (in progress)
147 - give good practices about filtering, security
148 - see problems from old docs/TODO notes on iccattut
149 - files/tutorial*: s/tutorial-*.log/tutorial.*.log/
150
8a8fb40 @docelic As usual, I am wonderful ;-) Here's the reason this time:
docelic authored
151 GLOSSARY:
152 Say about accesskeys in html source, for key-based navigation
153 tag, interpolation, reparse, symbol types
154 catalog/global variable, tag,ui,
155 action, form, unix inet socket, values,
156 regex, flypage, sku
157
158
159
160
161 NON DOCS RELATED
162 - Image tag, sort out mgkpath thing
f56b1e1 @docelic Just small "managemental" commit.
docelic authored
163
164
165
166 Nice but not fitting the idea
167 - CVS 'ident' command
168 - Suppress inline docs (in source) for items that have xmldocs docs
169 - In source contexts, for tags, highlight tagCanon and provide <acronym> with
170 short explanation and example
5f3f31f @docelic - Some new stuff, some placeholders, some updates/fixes to existing f…
docelic authored
171
172
173
174 In IC source:
175
176 - No $Vend::XTrailer on <input>, etc..
177 - missing </p>s
178 - lowercase SELECTED/CHECKED ?
179
34d199b @docelic - Makefile: turn orderchecks back on (the error that prevented them from
docelic authored
180
181 Check CartTrigger[Quantity]
ea81180 @docelic * bin/refs-autogen: another place for improvement. Namely, if the item
docelic authored
182
183
184
185 Community-contributed usertags (was usertag.pod before 4.7.0; too messy)
186 icstart - Getting Started Guide
187 * FAQ for each demo catalog (foundation, construct, barry, artstore)
188 * FAQ for each database (DBM, MySQL, PostgreSQL, Oracle)
189 * FAQ for each payment processor (CCVS, Cybercash, Signio, Authorize.net, etc.)
190
191
192
193 http://host/cgi-bin/cat?mv_pc=RESET (clears it, for debugging)
194 Otherwise mv_pc does double duty as a cache foiler, and is a meaningless,
195 incrementing integer.
196
197 -----------------------------------------------------------------------------
198
199 iccattut:
200 Switch to new payment settings instead of mv_cyber_mode etc.
201 To add
202 Discuss profile.order verification options like 'zip=zip' and then explain why we don't actually use that one much unless it's for a U.S.-only store
203 Problems?
204 [on-match] gets used if search returned no results on an empty search string. Why?
205 Doubled-up CC verification errors:
206 No error message is given in [error] if required form variables weren't passed at all (vs. being simply empty)
207 No error message if profiles.order can't be found
208
209 Discuss using images (from old mvdocs):
210 A public Web directory for inline image graphic files is needed. Interchange does not serve the images, only the HTML tags calling them. A useful convention is to place all buttonbars, backgrounds, and icons in the /images directory, with the catalog items located in the /images/catalog directory. Regardless of the directory structure, an I<absolute path> must be used. Relative paths are unacceptable. Use the I<ImageDir> directive, which places that as the absolute path in front of all relative IMG and INPUT SRC, and BODY, TABLE, TR, TH, and TD BACKGROUND specifications.
211
212
Something went wrong with that request. Please try again.