AkelPad Documentation
- Author
- Message
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
AkelPad Documentation
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓ DOCUMENTATION Links
▓
▓ Documents now being posted (officially) at:
▓ http://akelpad.sourceforge.net/files/docs/
▓
▓ and unofficially (newest and pre-release versions!) at:
▓http://members.shaw.ca/atbcls/akelpad/
▓ Current User Manual available is:
▓ - v12.11.20 (for AkelPad 4.8.0 - November 20, 2012), and
▓ - v1.2.7 (for AkelPad 3.7.0)
▓
▓Macro compiler/decompiler (MacTool) also available at above webpage
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
Hello! Surveyor (new member) here.
I am amazed at AkelPad's capabilities, but the documentation "leaves much to be desired". I have some time (semi-retired) and some skill at this, so I have undertaken to compile a User Manual in compiled HTML (.chm file). I can't figure out how to attach what I have done so far, so I have emailed "Instructor" with a copy. I would be happy to continue in this work, and possibly document plugins, as well.
BUT, in order to continue, I will need some questions answered from time to time. For now, the 2 things I can't figure out properly are:
1. in the Find or Replace dialog, how do you enter HEX code for searching?
2. Window/Tabs/left-right (in MDI mode) What does it do?
Also, if you find this project suitable, it would be nice to include a help file in the packages, and add a menu item to the Help menu (only About there now). Context-sensitive help is also possible, but not really necessary, I think (requires additional source code modifications, of course).
If you find my file satisfactory (preliminary only, for now, but gives an idea of what can be done), could you post it to the Forum so that others may have a look and comment? Thanks - great work in creating AkelPad. There is a lot more power to it than casual users will see, especially once plugins are used!
- Surveyor
Last edited by Surveyor on Tue Nov 20, 2012 6:18 pm, edited 56 times in total.
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
A preliminary copy of the User Manual (documentation) can be downloaded at:
http//mypage.direct.ca/a/atbcls/temp/AkelPad_v3.4.7_User_Manual.chm.zip
link now void, see top of thread
Work continues in completing the first release, and reducing the size of the CHM file by modifying the images (which make up most of the size). Images are important to the ease of use.
Note
Instructor has kindly placed a copy of the preliminary documentation at:
link now void, see top of thread
I will update this with him as work progresses.
The link at mypage may disappear in the future, if I get a new ISP!
- Surveyor
http//mypage.direct.ca/a/atbcls/temp/AkelPad_v3.4.7_User_Manual.chm.zip
link now void, see top of thread
Work continues in completing the first release, and reducing the size of the CHM file by modifying the images (which make up most of the size). Images are important to the ease of use.
Note
Instructor has kindly placed a copy of the preliminary documentation at:
link now void, see top of thread
I will update this with him as work progresses.
The link at mypage may disappear in the future, if I get a new ISP!
- Surveyor
Last edited by Surveyor on Tue Mar 23, 2010 2:44 pm, edited 2 times in total.
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
Surveyor here - greetings from Canada!
I have been busy on the documentation; my wife slips food under the door occasionally and I sleep at my desk (just kidding...).
Here is another preliminary version (v0.2) which can be obtained at the following links:
AkelPad-Eng.chm - 349 KB
AkelPad-Eng-lean.chm - 267 KB
links now void, see top of thread
The "lean" version is identical to the normal one, except images have been altered to conserve space.
As before, I trust that Instructor will be posting these updates at:
http://akelpad.sourceforge.net/files/docs/
I appeal to readers/members for some assistance on a few upcoming topics in the manual. I would appreciate any thoughts you have regarding
- Surveyor
I have been busy on the documentation; my wife slips food under the door occasionally and I sleep at my desk (just kidding...).
Here is another preliminary version (v0.2) which can be obtained at the following links:
AkelPad-Eng.chm - 349 KB
AkelPad-Eng-lean.chm - 267 KB
links now void, see top of thread
The "lean" version is identical to the normal one, except images have been altered to conserve space.
As before, I trust that Instructor will be posting these updates at:
http://akelpad.sourceforge.net/files/docs/
I appeal to readers/members for some assistance on a few upcoming topics in the manual. I would appreciate any thoughts you have regarding
- info related to Settings -> default codepage and codepage recognition
- hyperlinks - how to create, how they work
- a method to migrate ALL existing registry settings to an INI file, for portablility. Currently, I think some visual settings are not "picked up"when you change from registry to INI.
- typos, additions, subtractions or corrections in the current text
- Surveyor
Last edited by Surveyor on Wed Feb 27, 2008 7:03 pm, edited 1 time in total.
-
Offline
- Site Admin
- Posts: 6311
- Joined: Thu Jul 06, 2006 7:20 am
Emails returns back.
When no code page detected, file openning in default code page. Initially AkelPad set default code page as the system default ANSI code page.
Codepage filter:
Manages code page list that apeared in Open/Save dialog and in status bar context menu (F12).
Codepage recognition:
It is the special algorithm for recognize ANSI (non-Unicode) files. For example, Russian PC community uses 3 ANSI code pages 1251, 866, 20866. If "codepage recognition" set to none, then AkelPad detect only Unicode files with BOM and UTF-16LE, UTF-16BE without BOM.
Codepage recognition buffer:
How many characters will be tested.
http: file: mailto: ftp: https: gopher: nntp: prospero: telnet: news: wais:
For example, if you type http://akelpad.sourceforge.net/forum/ AkelPad will highlight it and you can click on it. Note: url detection will slow down file openning.
>AkelPad 3.3.3
>Changed: if edit font, print font, background color and text color didn't changed by user, then they don't >writing in program settings.
Default codepage:info related to Settings -> default codepage and codepage recognition
When no code page detected, file openning in default code page. Initially AkelPad set default code page as the system default ANSI code page.
Codepage filter:
Manages code page list that apeared in Open/Save dialog and in status bar context menu (F12).
Codepage recognition:
It is the special algorithm for recognize ANSI (non-Unicode) files. For example, Russian PC community uses 3 ANSI code pages 1251, 866, 20866. If "codepage recognition" set to none, then AkelPad detect only Unicode files with BOM and UTF-16LE, UTF-16BE without BOM.
Codepage recognition buffer:
How many characters will be tested.
When you turn-on hyperlinks option, AkelPad will detect next prefixes:hyperlinks - how to create, how they work
http: file: mailto: ftp: https: gopher: nntp: prospero: telnet: news: wais:
For example, if you type http://akelpad.sourceforge.net/forum/ AkelPad will highlight it and you can click on it. Note: url detection will slow down file openning.
From history:a method to migrate ALL existing registry settings to an INI file, for portablility. Currently, I think some visual settings are not "picked up"when you change from registry to INI.
>AkelPad 3.3.3
>Changed: if edit font, print font, background color and text color didn't changed by user, then they don't >writing in program settings.
FixedOverview:
1 AkelPad stores recent file history (unless set to 0) and recent search history (even if set to 0 - empty keys are still created on usage) in the registry.
User can sucessfully replace "321" with "123".Edit/Replace:
The replacement text need not be the same length (ie. number of characters) as the search text.
This is AkelPad-3.4.7-setup.exe only compiling omission. In 3.4.8 and in versions before 3.4.7 executable compiled in English.View/Language:
The zip archive (AkelPad-3.4.7-bin-eng.zip) contains a "compiled in English" version, while the installer package (AkelPad-3.4.7-setup.exe) is "compiled in Russian"!
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
(drum roll, please!)
Version 1.0 (final) of the new User Manual is now released! It should be posted on the "/docs" site soon - see first message of this thread for the link. In the meantime, try the other links for "AkelPad-Eng.chm" and "AkelPad-Eng-lean.chm" - they are no longer preliminary.
The final version has not been completely reviewed by Instructor; check back for any revisions, although they should be minor.
This has been a worthwhile project - AkelPad is an excellent tool!
- Surveyor
Version 1.0 (final) of the new User Manual is now released! It should be posted on the "/docs" site soon - see first message of this thread for the link. In the meantime, try the other links for "AkelPad-Eng.chm" and "AkelPad-Eng-lean.chm" - they are no longer preliminary.
The final version has not been completely reviewed by Instructor; check back for any revisions, although they should be minor.
This has been a worthwhile project - AkelPad is an excellent tool!
- Surveyor
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
Message to all AkelPad users,
Documentation is now being posted in 2 places:
- on my freebie ISP website immediately, and
- on the AkelPad Sourceforg site, although there may be a 1-2 day delay, depending on circumstances.
See top of this thread for links to both places. Special thanks to Instructor for his usual prompt response and help in the documentation. I know that real life (work, families, etc) sometimes interferes with the fun things we really want to do - like programming!
- Surveyor
Documentation is now being posted in 2 places:
- on my freebie ISP website immediately, and
- on the AkelPad Sourceforg site, although there may be a 1-2 day delay, depending on circumstances.
See top of this thread for links to both places. Special thanks to Instructor for his usual prompt response and help in the documentation. I know that real life (work, families, etc) sometimes interferes with the fun things we really want to do - like programming!
- Surveyor
Last edited by Surveyor on Fri Dec 26, 2008 4:44 pm, edited 2 times in total.
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
A small supplement has been posted for the recent update to AkelPad 3.5.1.
I intend to release "a few" supplements, then integrate them into a new version of the User Manual in the future, in order save users (and me!) some effort.
Update - supplement idea is not practical; I hope to update manual as new features, etc. are added. ( Apr 1/08 )
- Surveyor
I intend to release "a few" supplements, then integrate them into a new version of the User Manual in the future, in order save users (and me!) some effort.
Update - supplement idea is not practical; I hope to update manual as new features, etc. are added. ( Apr 1/08 )
- Surveyor
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
To DV,
Thanks for your comments - you are the first (other than Instructor) to reply! You are probably right; I included that section there near the end of my preparation of the user guide. I will (undoubtedly!) be releasing an update for new features/changes as they occur - I will consider moving that section to its own "appendix".
- Surveyor
Thanks for your comments - you are the first (other than Instructor) to reply! You are probably right; I included that section there near the end of my preparation of the user guide. I will (undoubtedly!) be releasing an update for new features/changes as they occur - I will consider moving that section to its own "appendix".
- Surveyor
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
I'm BACK!
Surveyor here!
My last (posted) revision of the documentation was "way back" on April 1st, 2008 and was current for AkelPad version 3.5.4. I see that much work has been done in AkelPad since then! At that time I was involved with
Stay tuned (hopefully) for the following future documentation:
- Surveyor
My last (posted) revision of the documentation was "way back" on April 1st, 2008 and was current for AkelPad version 3.5.4. I see that much work has been done in AkelPad since then! At that time I was involved with
- retirement and winding down my business, and
- moving (some distance)
Stay tuned (hopefully) for the following future documentation:
- User Manual updated to version 4.x.x
- addition of a separate manual to cover (some!) plugins. A little taste of this can be found at http://akelpad.sourceforge.net/files/docs.
Take note: my affiliation with "direct.ca" has been discontinued and any links to my former "site" may be invalid. See new link at top of this forum!
- Surveyor
Last edited by Surveyor on Tue Dec 23, 2008 2:32 am, edited 2 times in total.
-
Offline
- Posts: 147
- Joined: Fri Feb 08, 2008 6:41 pm
- Location: British Columbia, Canada
Thank you all (Instructor, u_u86, city_zen, infimum and others) for the kind words!
Preparation (and maintenance) of the manuals is a fair bit of work, but I think it is a worthy project. I am a big fan of freeware and open source software in general, but much of it suffers from the same illness , ...
Preparation (and maintenance) of the manuals is a fair bit of work, but I think it is a worthy project. I am a big fan of freeware and open source software in general, but much of it suffers from the same illness , ...