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