forked from KolibriOS/kolibrios
Rename UPPEDCASE.TXT doc files into TitleCase.txt files.
Unify names: Grobfara vs Fara, GNU vs Copying. Remove non-translated et_EE docs.
This commit is contained in:
leency
@@ -310,20 +310,20 @@ extra_files = {
|
||||
{"kolibrios/utils/tedit/info/INI.SYN", VAR_PROGS .. "/other/t_edit/info/ini_files.syn"},
|
||||
}
|
||||
if build_type == "ru_RU" then tup.append_table(extra_files, {
|
||||
{"Docs/cp866/config.txt", build_type .. "/docs/CONFIG.TXT"},
|
||||
{"Docs/cp866/gnu.txt", build_type .. "/docs/GNU.TXT"},
|
||||
{"Docs/cp866/history.txt", build_type .. "/docs/HISTORY.TXT"},
|
||||
{"Docs/cp866/hot_keys.txt", build_type .. "/docs/HOT_KEYS.TXT"},
|
||||
{"Docs/cp866/install.txt", build_type .. "/docs/INSTALL.TXT"},
|
||||
{"Docs/cp866/credits.txt", build_type .. "/docs/CREDITS.TXT"},
|
||||
{"Docs/cp866/sysfuncr.txt", VAR_PROGS .. "/system/docpack/trunk/SYSFUNCR.TXT"},
|
||||
{"Docs/cp1251/config.txt", VAR_DATA .. "/" .. build_type .. "/docs/CONFIG.WIN.TXT", cp1251_from = build_type .. "/docs/CONFIG.TXT"},
|
||||
{"Docs/cp1251/gnu.txt", "$(VAR_DATA)/$(build_type)/docs/GNU.WIN.TXT", cp1251_from = build_type .. "/docs/GNU.TXT"},
|
||||
{"Docs/cp1251/history.txt", "$(VAR_DATA)/$(build_type)/docs/HISTORY.WIN.TXT", cp1251_from = build_type .. "/docs/HISTORY.TXT"},
|
||||
{"Docs/cp1251/hot_keys.txt", "$(VAR_DATA)/$(build_type)/docs/HOT_KEYS.WIN.TXT", cp1251_from = build_type .. "/docs/HOT_KEYS.TXT"},
|
||||
{"Docs/cp1251/install.txt", "$(VAR_DATA)/$(build_type)/docs/INSTALL.WIN.TXT", cp1251_from = build_type .. "/docs/INSTALL.TXT"},
|
||||
{"Docs/cp1251/credits.txt", "$(VAR_DATA)/$(build_type)/docs/CREDITS.WIN.TXT", cp1251_from = build_type .. "/docs/CREDITS.TXT"},
|
||||
{"Docs/cp1251/sysfuncr.txt", "$(VAR_DATA)/$(build_type)/docs/SYSFUNCR.WIN.TXT", cp1251_from = SRC_PROGS .. "/system/docpack/trunk/SYSFUNCR.TXT"},
|
||||
{"Docs/cp866/Config.txt", build_type .. "/docs/Config.txt"},
|
||||
{"Docs/cp866/Copying.txt", build_type .. "/docs/Copying.txt"},
|
||||
{"Docs/cp866/History.txt", build_type .. "/docs/History.txt"},
|
||||
{"Docs/cp866/Hot_Keys.txt", build_type .. "/docs/Hot_Keys.txt"},
|
||||
{"Docs/cp866/Install.txt", build_type .. "/docs/Install.txt"},
|
||||
{"Docs/cp866/Credits.txt", build_type .. "/docs/Credits.txt"},
|
||||
{"Docs/cp866/SysFuncr.txt", VAR_PROGS .. "/system/docpack/trunk/SysFuncr.txt"},
|
||||
{"Docs/cp1251/Config.txt", VAR_DATA .. "/" .. build_type .. "/docs/CONFIG.WIN.TXT", cp1251_from = build_type .. "/docs/Config.txt"},
|
||||
{"Docs/cp1251/Copying.txt", "$(VAR_DATA)/$(build_type)/docs/COPYING.WIN.TXT", cp1251_from = build_type .. "/docs/Copying.txt"},
|
||||
{"Docs/cp1251/History.txt", "$(VAR_DATA)/$(build_type)/docs/HISTORY.WIN.TXT", cp1251_from = build_type .. "/docs/History.txt"},
|
||||
{"Docs/cp1251/Hot_Keys.txt", "$(VAR_DATA)/$(build_type)/docs/HOT_KEYS.WIN.TXT", cp1251_from = build_type .. "/docs/Hot_Keys.txt"},
|
||||
{"Docs/cp1251/Install.txt", "$(VAR_DATA)/$(build_type)/docs/INSTALL.WIN.TXT", cp1251_from = build_type .. "/docs/Install.txt"},
|
||||
{"Docs/cp1251/credits.txt", "$(VAR_DATA)/$(build_type)/docs/CREDITS.WIN.TXT", cp1251_from = build_type .. "/docs/Credits.txt"},
|
||||
{"Docs/cp1251/SysFuncr.txt", "$(VAR_DATA)/$(build_type)/docs/SYSFUNCR.WIN.TXT", cp1251_from = SRC_PROGS .. "/system/docpack/trunk/SysFuncr.txt"},
|
||||
{"HD_Load/9x2klbr/", SRC_PROGS .. "/hd_load/9x2klbr/readme_dos.txt"},
|
||||
{"HD_Load/9x2klbr/", SRC_PROGS .. "/hd_load/9x2klbr/readme_win.txt"},
|
||||
{"HD_Load/mtldr/", SRC_PROGS .. "/hd_load/mtldr/install.txt"},
|
||||
@@ -341,12 +341,12 @@ if build_type == "ru_RU" then tup.append_table(extra_files, {
|
||||
{"kolibrios/res/guide/", build_type .. "/docs/guide/*"},
|
||||
{"kolibrios/develop/tcc/doc/", SRC_PROGS .. "/develop/ktcc/trunk/bin/doc/ru/*"},
|
||||
}) else tup.append_table(extra_files, {
|
||||
{"Docs/config.txt", build_type .. "/docs/CONFIG.TXT"},
|
||||
{"Docs/copying.txt", build_type .. "/docs/COPYING.TXT"},
|
||||
{"Docs/hot_keys.txt", build_type .. "/docs/HOT_KEYS.TXT"},
|
||||
{"Docs/install.txt", build_type .. "/docs/INSTALL.TXT"},
|
||||
{"Docs/credits.txt", build_type .. "/docs/CREDITS.TXT"},
|
||||
{"Docs/sysfuncs.txt", VAR_PROGS .. "/system/docpack/trunk/SYSFUNCS.TXT"},
|
||||
{"Docs/Config.txt", build_type .. "/docs/Config.txt"},
|
||||
{"Docs/Copying.txt", build_type .. "/docs/Copying.txt"},
|
||||
{"Docs/Hot_Keys.txt", build_type .. "/docs/Hot_Keys.txt"},
|
||||
{"Docs/Install.txt", build_type .. "/docs/Install.txt"},
|
||||
{"Docs/Credits.txt", build_type .. "/docs/Credits.txt"},
|
||||
{"Docs/SysFuncs.txt", VAR_PROGS .. "/system/docpack/trunk/SysFuncs.txt"},
|
||||
{"HD_Load/9x2klbr/", SRC_PROGS .. "/hd_load/9x2klbr/readme.txt"},
|
||||
{"HD_Load/mtldr/install.txt", SRC_PROGS .. "/hd_load/mtldr/install_eng.txt"},
|
||||
{"HD_Load/USB_Boot/readme.txt", SRC_PROGS .. "/hd_load/usb_boot/readme_eng.txt"},
|
||||
|
||||
@@ -1,8 +0,0 @@
|
||||
KolibriOS 0.7.7.0+ nightly build, Live CD version.
|
||||
|
||||
This is a bootable CD-ROM. To run, reboot your computer and select the
|
||||
correct drive from the system settings or BIOS if required.
|
||||
|
||||
The minimum system requirements and installation instructions can be found
|
||||
in 'install.txt'. Further details for configuring and customizing KolibriOS
|
||||
are given in 'config.txt'.
|
||||
@@ -1,5 +0,0 @@
|
||||
KolibriOS 0.7.7.0+ nightly build.
|
||||
|
||||
The minimum system requirements and installation instructions can be found
|
||||
in 'install.txt'. Further details for configuring and customizing KolibriOS
|
||||
are given in 'config.txt'.
|
||||
@@ -1,98 +0,0 @@
|
||||
KolibriOS allows some configures for user requirements. This file describes
|
||||
such settings.
|
||||
For this it is required to change files on ramdisk. If you boot from floppy,
|
||||
there is no problem - change files on floppy. If you use floppy image
|
||||
kolibri.img - either use program which can work with images (for example,
|
||||
WinImage or DiskExplorer) or make changes from Kolibri and do not forget to
|
||||
save ramdisk (with the application rdsave).
|
||||
|
||||
1. Desktop background.
|
||||
a) Replace in the file autorun.dat (it is text file) the parameter for
|
||||
the program kiv ("\S__background.jpg") the name of file to the full
|
||||
Kolibri-path to JPEG-, BMP-, GIF- or PNG-image which you like. It will be
|
||||
new background. background.jpg now can be deleted.
|
||||
b) Replace in the file autorun.dat "/SYS/KIV \S__background.jpg" to
|
||||
"/sys/PIC4" (spaces are ignored by the loader program). You can delete
|
||||
BACKGROUND.JPG. New background will be nice texture.
|
||||
For programmers: you can change texture and color, for this in file
|
||||
pic4.asm from distributive sources change:
|
||||
* to change texture: value of variable usearray (string 585)
|
||||
from ptarray to any of ptarray2,ptarray3, ..., ptarray9.
|
||||
* to change color: in procedure check_parameters find string with
|
||||
the appropriate comment (string 127) and add to 0x40000 1 or 2.
|
||||
After changes recompile pic4, by request pack with kpack (in
|
||||
distributive is so), inject to ramdisk.
|
||||
c) Two previous points sets background for a long time (until next
|
||||
reinstall). It is possible also after Kolibri boot to set background
|
||||
until next reboot in programs kiv, iconedit, pic4, tinyfrac.
|
||||
|
||||
2. Configure system menu.
|
||||
Data for system menu are placed in text file menu.dat. It can be edited
|
||||
in any editor keeping format. If you use Kolibri TINYPAD, you
|
||||
must disable option "optimal fill on saving".
|
||||
|
||||
3. Configure autorun.
|
||||
The list of programs, loading when system boots, is read out from
|
||||
text file autorun.dat. It can be changed in any editor keeping format.
|
||||
For example, you can add as first item start of application startmus
|
||||
(delay 1, without arguments) to hear distinctive melody each time at
|
||||
booting.
|
||||
For programmers: you can change melody, for this edit file startmus.asm
|
||||
from distributive sources: there you can choose melody from three existing
|
||||
or add your own - format of melody is explained in documentation on
|
||||
subfunction 55 of function 55.
|
||||
|
||||
4. Icons list.
|
||||
The list of desktop icons is kept in text file icons.dat, but to
|
||||
change the list it is recommended to use icon manager icon (which can
|
||||
be run from desktop context menu). Images for icons are kept in file
|
||||
iconstrp.gif, which must be edited by external graphics editor.
|
||||
|
||||
5. Skin.
|
||||
The skin can be viewed and changed dynamically with the application
|
||||
desktop; after you choose most likely for you skin, you can make it
|
||||
permanent by replace file default.skn, from which system loads skin at
|
||||
booting. Standard skin is included to ramdisk, some alternative skins can
|
||||
be found in distributive in the folder Skins. You can also create your own
|
||||
skin, for detailed comments look at distributive sources.
|
||||
|
||||
6. Sound.
|
||||
Driver sound.sys, which is located on ramdisk by default, is intended for
|
||||
south bridges Intel ICH, ICH0, ICH2, ICH3, ICH4, ICH5, ICH6, ICH7 and
|
||||
NVidia NForce, NForce 2, NForce 3, NForce 4. If you have SB16-compatible
|
||||
sound card, remove sound.sys and rename sb16.sys from the folder 'drivers'
|
||||
to sound.sys. If you have controller sis7012, rename sis.sys from root
|
||||
folder in distributive to sound.sys and copy it to floppy or image to
|
||||
the folder 'drivers' (replacing old). The driver fm801.sys can be useful
|
||||
for ForceMedia FM801 controller, the driver vt8235.sys - for VIA chipsets,
|
||||
the driver emu10k1x.sys - for EMU10K1X audioprocessor, all are intended to
|
||||
similar with previous case use: copy it to the folder 'drivers' as
|
||||
'sound.sys', replacing the old file.
|
||||
|
||||
7. Bus Disconnect.
|
||||
The application KBD (Kolibri Bus Disconnect) allows to disconnect processor
|
||||
bus in order to decrease its temperature, a side effect is noise in AC97
|
||||
codecs. The application can be loaded automatically at system boot, to do
|
||||
this add to autorun (file autorun.dat, see 3) a line of the form
|
||||
"/SYS/KBD BOOT 20 # Enable Bus Disconnect for AMD K7 processors".
|
||||
|
||||
8. Network settings.
|
||||
Initial network configuration is read at boot from the ini file
|
||||
/sys/network/zeroconf.ini. You can set automatic detection with DHCP
|
||||
("type=zeroconf") or fixed IP addresses ("type=static").
|
||||
|
||||
9. Configuration of videomode for ATI videocards.
|
||||
The driver for ATI can set required screen resolution with refresh rate
|
||||
at system startup, if they are supported. The list of supported modes
|
||||
can be obtained with the utility VMODE, it allows also manual mode setting.
|
||||
To set the mode at startup one must pass to the loader ATIKMS, described
|
||||
in AUTORUN.DAT, the argument -m<width>x<height>x<refresh>, e.g.
|
||||
|
||||
/SYS/DRIVERS/ATIKMS -m1024x768x60 -1
|
||||
|
||||
Pay attention that the format of autorun.dat does not allow spaces in
|
||||
command line, so there must be no other arguments.
|
||||
Also one can disable ability to change videomodes and all linked actions
|
||||
at startup by passing the argument -n. The driver will still support
|
||||
hardware cursor. To fully disable the driver, one can simply delete
|
||||
the line with ATIKMS from autorun.dat.
|
||||
@@ -1,347 +0,0 @@
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
|
||||
Version 2, June 1991
|
||||
|
||||
|
||||
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
||||
675 Mass Ave, Cambridge, MA 02139, USA
|
||||
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
|
||||
Preamble
|
||||
|
||||
The licenses for most software are designed to take away your
|
||||
freedom to share and change it. By contrast, the GNU General Public
|
||||
License is intended to guarantee your freedom to share and change free
|
||||
software--to make sure the software is free for all its users. This
|
||||
General Public License applies to most of the Free Software
|
||||
Foundation's software and to any other program whose authors commit to
|
||||
using it. (Some other Free Software Foundation software is covered by
|
||||
the GNU Library General Public License instead.) You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
this service if you wish), that you receive source code or can get it
|
||||
if you want it, that you can change the software or use pieces of it
|
||||
in new free programs; and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to make restrictions that forbid
|
||||
anyone to deny you these rights or to ask you to surrender the rights.
|
||||
These restrictions translate to certain responsibilities for you if you
|
||||
distribute copies of the software, or if you modify it.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must give the recipients all the rights that
|
||||
you have. You must make sure that they, too, receive or can get the
|
||||
source code. And you must show them these terms so they know their
|
||||
rights.
|
||||
|
||||
We protect your rights with two steps: (1) copyright the software, and
|
||||
(2) offer you this license which gives you legal permission to copy,
|
||||
distribute and/or modify the software.
|
||||
|
||||
Also, for each author's protection and ours, we want to make certain
|
||||
that everyone understands that there is no warranty for this free
|
||||
software. If the software is modified by someone else and passed on, we
|
||||
want its recipients to know that what they have is not the original, so
|
||||
that any problems introduced by others will not reflect on the original
|
||||
authors' reputations.
|
||||
|
||||
Finally, any free program is threatened constantly by software
|
||||
patents. We wish to avoid the danger that redistributors of a free
|
||||
program will individually obtain patent licenses, in effect making the
|
||||
program proprietary. To prevent this, we have made it clear that any
|
||||
patent must be licensed for everyone's free use or not licensed at all.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
|
||||
0. This License applies to any program or other work which contains
|
||||
a notice placed by the copyright holder saying it may be distributed
|
||||
under the terms of this General Public License. The "Program", below,
|
||||
refers to any such program or work, and a "work based on the Program"
|
||||
means either the Program or any derivative work under copyright law:
|
||||
that is to say, a work containing the Program or a portion of it,
|
||||
either verbatim or with modifications and/or translated into another
|
||||
language. (Hereinafter, translation is included without limitation in
|
||||
the term "modification".) Each licensee is addressed as "you".
|
||||
|
||||
Activities other than copying, distribution and modification are not
|
||||
covered by this License; they are outside its scope. The act of
|
||||
running the Program is not restricted, and the output from the Program
|
||||
is covered only if its contents constitute a work based on the
|
||||
Program (independent of having been made by running the Program).
|
||||
Whether that is true depends on what the Program does.
|
||||
|
||||
1. You may copy and distribute verbatim copies of the Program's
|
||||
source code as you receive it, in any medium, provided that you
|
||||
conspicuously and appropriately publish on each copy an appropriate
|
||||
copyright notice and disclaimer of warranty; keep intact all the
|
||||
notices that refer to this License and to the absence of any warranty;
|
||||
and give any other recipients of the Program a copy of this License
|
||||
along with the Program.
|
||||
|
||||
You may charge a fee for the physical act of transferring a copy, and
|
||||
you may at your option offer warranty protection in exchange for a fee.
|
||||
|
||||
2. You may modify your copy or copies of the Program or any portion
|
||||
of it, thus forming a work based on the Program, and copy and
|
||||
distribute such modifications or work under the terms of Section 1
|
||||
above, provided that you also meet all of these conditions:
|
||||
|
||||
a) You must cause the modified files to carry prominent notices
|
||||
stating that you changed the files and the date of any change.
|
||||
|
||||
b) You must cause any work that you distribute or publish, that in
|
||||
whole or in part contains or is derived from the Program or any
|
||||
part thereof, to be licensed as a whole at no charge to all third
|
||||
parties under the terms of this License.
|
||||
|
||||
c) If the modified program normally reads commands interactively
|
||||
when run, you must cause it, when started running for such
|
||||
interactive use in the most ordinary way, to print or display an
|
||||
announcement including an appropriate copyright notice and a
|
||||
notice that there is no warranty (or else, saying that you provide
|
||||
a warranty) and that users may redistribute the program under
|
||||
these conditions, and telling the user how to view a copy of this
|
||||
License. (Exception: if the Program itself is interactive but
|
||||
does not normally print such an announcement, your work based on
|
||||
the Program is not required to print an announcement.)
|
||||
|
||||
These requirements apply to the modified work as a whole. If
|
||||
identifiable sections of that work are not derived from the Program,
|
||||
and can be reasonably considered independent and separate works in
|
||||
themselves, then this License, and its terms, do not apply to those
|
||||
sections when you distribute them as separate works. But when you
|
||||
distribute the same sections as part of a whole which is a work based
|
||||
on the Program, the distribution of the whole must be on the terms of
|
||||
this License, whose permissions for other licensees extend to the
|
||||
entire whole, and thus to each and every part regardless of who wrote it.
|
||||
|
||||
Thus, it is not the intent of this section to claim rights or contest
|
||||
your rights to work written entirely by you; rather, the intent is to
|
||||
exercise the right to control the distribution of derivative or
|
||||
collective works based on the Program.
|
||||
|
||||
In addition, mere aggregation of another work not based on the Program
|
||||
with the Program (or with a work based on the Program) on a volume of
|
||||
a storage or distribution medium does not bring the other work under
|
||||
the scope of this License.
|
||||
|
||||
3. You may copy and distribute the Program (or a work based on it,
|
||||
under Section 2) in object code or executable form under the terms of
|
||||
Sections 1 and 2 above provided that you also do one of the following:
|
||||
|
||||
a) Accompany it with the complete corresponding machine-readable
|
||||
source code, which must be distributed under the terms of Sections
|
||||
1 and 2 above on a medium customarily used for software interchange; or,
|
||||
|
||||
b) Accompany it with a written offer, valid for at least three
|
||||
years, to give any third party, for a charge no more than your
|
||||
cost of physically performing source distribution, a complete
|
||||
machine-readable copy of the corresponding source code, to be
|
||||
distributed under the terms of Sections 1 and 2 above on a medium
|
||||
customarily used for software interchange; or,
|
||||
|
||||
c) Accompany it with the information you received as to the offer
|
||||
to distribute corresponding source code. (This alternative is
|
||||
allowed only for noncommercial distribution and only if you
|
||||
received the program in object code or executable form with such
|
||||
an offer, in accord with Subsection b above.)
|
||||
|
||||
The source code for a work means the preferred form of the work for
|
||||
making modifications to it. For an executable work, complete source
|
||||
code means all the source code for all modules it contains, plus any
|
||||
associated interface definition files, plus the scripts used to
|
||||
control compilation and installation of the executable. However, as a
|
||||
special exception, the source code distributed need not include
|
||||
anything that is normally distributed (in either source or binary
|
||||
form) with the major components (compiler, kernel, and so on) of the
|
||||
operating system on which the executable runs, unless that component
|
||||
itself accompanies the executable.
|
||||
|
||||
If distribution of executable or object code is made by offering
|
||||
access to copy from a designated place, then offering equivalent
|
||||
access to copy the source code from the same place counts as
|
||||
distribution of the source code, even though third parties are not
|
||||
compelled to copy the source along with the object code.
|
||||
|
||||
4. You may not copy, modify, sublicense, or distribute the Program
|
||||
except as expressly provided under this License. Any attempt
|
||||
otherwise to copy, modify, sublicense or distribute the Program is
|
||||
void, and will automatically terminate your rights under this License.
|
||||
However, parties who have received copies, or rights, from you under
|
||||
this License will not have their licenses terminated so long as such
|
||||
parties remain in full compliance.
|
||||
|
||||
5. You are not required to accept this License, since you have not
|
||||
signed it. However, nothing else grants you permission to modify or
|
||||
distribute the Program or its derivative works. These actions are
|
||||
prohibited by law if you do not accept this License. Therefore, by
|
||||
modifying or distributing the Program (or any work based on the
|
||||
Program), you indicate your acceptance of this License to do so, and
|
||||
all its terms and conditions for copying, distributing or modifying
|
||||
the Program or works based on it.
|
||||
|
||||
6. Each time you redistribute the Program (or any work based on the
|
||||
Program), the recipient automatically receives a license from the
|
||||
original licensor to copy, distribute or modify the Program subject to
|
||||
these terms and conditions. You may not impose any further
|
||||
restrictions on the recipients' exercise of the rights granted herein.
|
||||
You are not responsible for enforcing compliance by third parties to
|
||||
this License.
|
||||
|
||||
7. If, as a consequence of a court judgment or allegation of patent
|
||||
infringement or for any other reason (not limited to patent issues),
|
||||
conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot
|
||||
distribute so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you
|
||||
may not distribute the Program at all. For example, if a patent
|
||||
license would not permit royalty-free redistribution of the Program by
|
||||
all those who receive copies directly or indirectly through you, then
|
||||
the only way you could satisfy both it and this License would be to
|
||||
refrain entirely from distribution of the Program.
|
||||
|
||||
If any portion of this section is held invalid or unenforceable under
|
||||
any particular circumstance, the balance of the section is intended to
|
||||
apply and the section as a whole is intended to apply in other
|
||||
circumstances.
|
||||
|
||||
It is not the purpose of this section to induce you to infringe any
|
||||
patents or other property right claims or to contest validity of any
|
||||
such claims; this section has the sole purpose of protecting the
|
||||
integrity of the free software distribution system, which is
|
||||
implemented by public license practices. Many people have made
|
||||
generous contributions to the wide range of software distributed
|
||||
through that system in reliance on consistent application of that
|
||||
system; it is up to the author/donor to decide if he or she is willing
|
||||
to distribute software through any other system and a licensee cannot
|
||||
impose that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is believed to
|
||||
be a consequence of the rest of this License.
|
||||
|
||||
8. If the distribution and/or use of the Program is restricted in
|
||||
certain countries either by patents or by copyrighted interfaces, the
|
||||
original copyright holder who places the Program under this License
|
||||
may add an explicit geographical distribution limitation excluding
|
||||
those countries, so that distribution is permitted only in or among
|
||||
countries not thus excluded. In such case, this License incorporates
|
||||
the limitation as if written in the body of this License.
|
||||
|
||||
9. The Free Software Foundation may publish revised and/or new versions
|
||||
of the General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the Program
|
||||
specifies a version number of this License which applies to it and "any
|
||||
later version", you have the option of following the terms and conditions
|
||||
either of that version or of any later version published by the Free
|
||||
Software Foundation. If the Program does not specify a version number of
|
||||
this License, you may choose any version ever published by the Free Software
|
||||
Foundation.
|
||||
|
||||
10. If you wish to incorporate parts of the Program into other free
|
||||
programs whose distribution conditions are different, write to the author
|
||||
to ask for permission. For software which is copyrighted by the Free
|
||||
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||
make exceptions for this. Our decision will be guided by the two goals
|
||||
of preserving the free status of all derivatives of our free software and
|
||||
of promoting the sharing and reuse of software generally.
|
||||
|
||||
NO WARRANTY
|
||||
|
||||
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||
REPAIR OR CORRECTION.
|
||||
|
||||
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGES.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
Appendix: How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
convey the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) 19yy <name of author>
|
||||
|
||||
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, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program is interactive, make it output a short notice like this
|
||||
when it starts in an interactive mode:
|
||||
|
||||
Gnomovision version 69, Copyright (C) 19yy name of author
|
||||
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, the commands you use may
|
||||
be called something other than `show w' and `show c'; they could even be
|
||||
mouse-clicks or menu items--whatever suits your program.
|
||||
|
||||
You should also get your employer (if you work as a programmer) or your
|
||||
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||
necessary. Here is a sample; alter the names:
|
||||
|
||||
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||
|
||||
<signature of Ty Coon>, 1 April 1989
|
||||
Ty Coon, President of Vice
|
||||
|
||||
This General Public License does not permit incorporating your program into
|
||||
proprietary programs. If your program is a subroutine library, you may
|
||||
consider it more useful to permit linking proprietary applications with the
|
||||
library. If this is what you want to do, use the GNU Library General
|
||||
Public License instead of this License.
|
||||
@@ -1,128 +0,0 @@
|
||||
|
||||
KolibriOS team
|
||||
--------------
|
||||
|
||||
We thank everyone who helped to create and develop KolibriOS,
|
||||
many of whom are listed below ~
|
||||
|
||||
System Programming (loaders, kernel, etc.) :
|
||||
- Alver
|
||||
- art_zh
|
||||
- Asper
|
||||
- Boppan
|
||||
- CleverMouse
|
||||
- Coldy
|
||||
- Doczom
|
||||
- dunkaist
|
||||
- Galkov
|
||||
- Evgeny Grechnikov 'Diamond'
|
||||
- Andrey Halyavin 'halyavin'
|
||||
- hidnplayr
|
||||
- Andrey Ignatiev 'andrew_programmer'
|
||||
- Johnny_B
|
||||
- kasTIgar
|
||||
- Sergey Kuzmin 'Wildwest'
|
||||
- Mihail Lisovin 'Mihasik'
|
||||
- Maxis
|
||||
- Iliya Mihailov 'Ghost'
|
||||
- Nable
|
||||
- NoName
|
||||
- Ivan Poddubny
|
||||
- rgimad
|
||||
- Rus
|
||||
- Mihail Semenyako 'mike.dld'
|
||||
- Sergey Semyonov 'Serge'
|
||||
- shurf
|
||||
- SPraid
|
||||
- Alexey Teplov '<Lrz>'
|
||||
- Trans
|
||||
- tsdima
|
||||
- turbanoff
|
||||
- VaStaNi
|
||||
- Marat Zakiyanov 'Mario79'
|
||||
|
||||
Application Programming (new creations, porting or revisions) :
|
||||
- Alver
|
||||
- art_zh
|
||||
- Artemonische
|
||||
- Asper
|
||||
- barsuk
|
||||
- Vitaly Bendik 'mistifi(ator'
|
||||
- Mario Birkner 'cYfleXX'
|
||||
- Aleksandr Bogomaz 'Albom'
|
||||
- chaykin
|
||||
- CleverMouse
|
||||
- DedOk
|
||||
- Dron2004
|
||||
- dunkaist
|
||||
- ealex
|
||||
- Pavlushin Evgeny 'Exis'
|
||||
- Maxim Evtihov 'Maxxxx32'
|
||||
- Gluk
|
||||
- Evgeny Grechnikov 'Diamond'
|
||||
- Maciej Guba 'macgub'
|
||||
- Andrey Halyavin 'halyavin'
|
||||
- Hex
|
||||
- iadn
|
||||
- Andrey Ignatiev 'andrew_programmer'
|
||||
- IgorA
|
||||
- Andrey Ivushkin 'Willow'
|
||||
- Johnny_B
|
||||
- kaitz
|
||||
- Vasiliy Kosenko 'vkos'
|
||||
- Sergey Kuzmin 'Wildwest'
|
||||
- Kirill Lipatov 'Leency'
|
||||
- Mihail Lisovin 'Mihasik'
|
||||
- Alexander Meshcheryakov 'Self-Perfection'
|
||||
- Iliya Mihailov 'Ghost'
|
||||
- Navanax
|
||||
- nilgui
|
||||
- Olaf
|
||||
- hidden player 'hidnplayr'
|
||||
- Ivan Poddubny
|
||||
- Pterox
|
||||
- Rus
|
||||
- Pavel Rymovski 'Heavyiron'
|
||||
- Mihail Semenyako 'mike.dld'
|
||||
- Sergey Semyonov 'Serge'
|
||||
- SPraid
|
||||
- staper
|
||||
- Alexey Teplov '<Lrz>'
|
||||
- trolly
|
||||
- tsdima
|
||||
- vectoroc
|
||||
- YELLOW
|
||||
- Vladimir Zaitsev 'Rabid Rabbit'
|
||||
- Marat Zakiyanov 'Mario79'
|
||||
|
||||
Documentation and Translation :
|
||||
- Andrew Dent 'ace_dent'
|
||||
- Evgeny Grechnikov 'Diamond'
|
||||
- Hex
|
||||
|
||||
Infrastructure (forum, site and SVN hosting) :
|
||||
- CodeWorld
|
||||
- mike.dld
|
||||
|
||||
Design (logo, background, icons) :
|
||||
- goglus
|
||||
- Kirill Lipatov 'Leency'
|
||||
- Alexey Teplov '<Lrz>'
|
||||
|
||||
Testing and Support :
|
||||
- AqwAS
|
||||
- Ataualpa
|
||||
- Vitaly Bendik 'mistifi(ator'
|
||||
- camper
|
||||
- ChE
|
||||
- Dmitry the Sorcerer
|
||||
- Galkov
|
||||
- Maxis
|
||||
- Mike
|
||||
- Pavel Rymovski 'Heavyiron'
|
||||
- vectoroc
|
||||
- Veliant
|
||||
|
||||
and many others...
|
||||
|
||||
KolibriOS team
|
||||
@@ -1,48 +0,0 @@
|
||||
PHARAOH TOMB
|
||||
|
||||
The purpose of the game is to open passage by moving hieroglyphs on entrance
|
||||
in the next room of the pharaoh tomb (8X8). You can exchange two hieroglyphs
|
||||
located near each other on vertical or horizontal if after such transposition
|
||||
a combination of three or more identical pictures abreast is generated. Such
|
||||
lines are disappeared immediately, and free place is filled by hieroglyphs
|
||||
which "falled" from top. Missing hieroglyphs are generated randomly. For
|
||||
disappearing hieroglyphs points are added. For combination of hieroglyphs
|
||||
number of points is calculated by formula L+(L+1)^(N-3), but no more than
|
||||
20*L*N, where N is number of hieroglyphs in combination, and L is level number.
|
||||
To pass to the next level it is required to remove certain number of
|
||||
hieroglyphs (different on each level). From below of panel with hieroglyphs is
|
||||
located field which indicates how many is passed and how many is remained.
|
||||
|
||||
1st level - 500
|
||||
2nd level - 450
|
||||
3rd level - 400
|
||||
4th level - 350
|
||||
5th level - 300
|
||||
6th level and further - 50*(L+1)
|
||||
|
||||
On the first level combinations are composed from 6 states of hieroglyphs.
|
||||
With each new level one new hieroglyph is involved, but no more than 10
|
||||
(i.e. starting from 5th level and further 10 different hieroglyphs are
|
||||
involved, not counting special ones).
|
||||
|
||||
Starting from 2nd level for each combination from 4 and more hieroglyphs,
|
||||
and also for passing each fourth of level the player gets "free" hieroglyph -
|
||||
it is usual hieroglyph (generated randomly), which keeps "in pocket" of player
|
||||
and can be necessarily inserted by player to any place and replace thus
|
||||
located there hieroglyph.
|
||||
|
||||
Starting from 3rd level for each combination from 5 and more hieroglyphs,
|
||||
and also for passing each third of level the player gets "universal key",
|
||||
which matches to any combination of hieroglyphs and to several different
|
||||
combination simultaneously.
|
||||
|
||||
Starting from 4th level for each combination from 6 and more hieroglyphs,
|
||||
and also for passing a half of level the player gets "space crooker",
|
||||
which allows, when is used, to make 3 moves (not obligatory successive) at
|
||||
diagonal.
|
||||
|
||||
The player can not have simultaneously more than 1 extra hieroglyph of each
|
||||
type (1 usual, 1 joker and 1 crooker).
|
||||
|
||||
The game is ended, if the player can not make any combination with existing
|
||||
hieroglyphs.
|
||||
@@ -1,14 +0,0 @@
|
||||
The following "hot" shortcut keys are used in the system:
|
||||
(Indexing on time of appearance in the system)
|
||||
1) Ctrl + Alt + Del start of the application CPU (the manager of processes), is a sole combination maintained on a level of a kernel, all rest "hot" key is realized at the expense of the application @TASKBAR.
|
||||
2) Ctrl + Shift - switching of keyboard layout.
|
||||
3) Win - start of the application MENU.
|
||||
4) Alt + Ctrl + F12 - start of the application END.
|
||||
5) Alt + F4 - terminate the active application.
|
||||
6) Alt + Tab - switch to the next (in the window stack) window
|
||||
7) Alt + Shift + Tab - switch to the previous (in the window stack) window
|
||||
8) Alt + Shift + NumLock - start of the application MOUSEMUL, which emulates mouse with numpad, when NumLock is on.
|
||||
9) Alt + 1...7 - fast switching to the selected keyboard layout (even if absent for Ctrl + Shift)
|
||||
10) Win + D - minimize/restore all windows (cleaning of desktop)
|
||||
11) Win + R - start of the application RUN
|
||||
12) Ctrl + PrintScreen - start of the application SCRSHOOT. Just do a screen shot and the user is offered to specify (with OpenDialog) where to save the BMP image.
|
||||
@@ -1,25 +0,0 @@
|
||||
Ini-files are text files of special contents:
|
||||
|
||||
[name of first section]
|
||||
Key1=value1
|
||||
Key2=value2
|
||||
;comment
|
||||
[name of second section]
|
||||
Key3=value3
|
||||
|
||||
All lines beginning with ';' are considered as comments and ignored.
|
||||
|
||||
Keyboard shortcuts are described as follows:
|
||||
any number of modificators Ctrl/Alt/Shift/LCtrl/LAlt/LShift/RCtrl/RAlt/RShift,
|
||||
followed by latin letter, digit or key name. The following keys have a name:
|
||||
F1 - F12
|
||||
Home; End; PgUp; PgDn; Ins, equivalently, Insert; Del, equivalently, Delete;
|
||||
Tab; Plus; Esc; Enter; Backspace; Space;
|
||||
Left (left arrow); Right (right arrow); Up (up arrow); Down (down arrow).
|
||||
The string for shortcut is case-insensitive. Parts of the string
|
||||
can be written without delimiters or with '+' between parts. Examples:
|
||||
Ctrl+Alt+Backspace
|
||||
RCtrl+RShift
|
||||
ShiftA
|
||||
f10
|
||||
shiftalt5
|
||||
@@ -1,92 +0,0 @@
|
||||
Minimal system requirements for KolibriOS:
|
||||
* CPU: Pentium, AMD 5x86 or Cyrix 5x86 without MMX with frequency 100 MHz
|
||||
* RAM: 8 Mb
|
||||
* Videocard: supporting VGA (640*480*16 mode) or Vesa
|
||||
* Keyboard: AT
|
||||
* Mouse: COM, PS/2 or USB
|
||||
|
||||
The system can boot from any of following devices:
|
||||
- Floppy 3.5
|
||||
- IDE HDD LBA
|
||||
- CD/DVD
|
||||
- USB Flash
|
||||
|
||||
I. Install to floppy.
|
||||
1) Insert clean floppy without bad sectors to drive.
|
||||
2) Write to it kolibri.img image with any available methods:
|
||||
a) (if you have already loaded Kolibri by any method) run the program
|
||||
rdsave and select the variant corresponding to floppy
|
||||
b) (for DOS and Windows) run subjoined install.bat
|
||||
c) with program WinImage or its analogue (e.g. DiskExplorer)
|
||||
d) (for Linux) set "executable" attribute to subjoined script install.sh
|
||||
and run it
|
||||
Now you can boot from floppy (keep it in drive, reboot, set in BIOS option
|
||||
of floppy booting).
|
||||
|
||||
II. Install to hard disk.
|
||||
There exists several loaders from hard disk. All are oriented on DOS and
|
||||
Windows users. Also standard Linux-loader GRUB can be used. All methods work
|
||||
with file kolibri.img. If you already have old version of Kolibri installed,
|
||||
simply replace kolibri.img to new. If you have booted from LiveCD, which
|
||||
does not contain the file kolibri.img, Kolibri can create it independently,
|
||||
to do this, run the program rdsave, enter the file name for saving and select
|
||||
the corresponding variant. Of course, in this case Kolibri must be able to
|
||||
write to file system of selected partitions, currently this means that
|
||||
only FAT volumes are ok.
|
||||
1) Most of all features has the loader mtldr (author - Diamond) - works with
|
||||
DOS/Win95/98/NT/2k/XP/Vista, supports FAT32 and NTFS, has installator, can
|
||||
be installed to any folder on disk.
|
||||
To install, simply run file HD_load\mtldr_install.exe and select image file.
|
||||
Apropos, by this way you can install several images. There is also
|
||||
variant of install by hand - for those who want to know what installator
|
||||
does: directions in HD_load\mtldr
|
||||
2) There is also the loader MeOSLoad (author - Trans, expanded by Mario79) -
|
||||
works with DOS/Win95/98, supports FAT32, it is placed with the instruction
|
||||
to the folder HD_load\MeOSLoad.
|
||||
3) Moreover, there exist a program which allow load Kolibri directly from
|
||||
Windows 95/98/Me (of course, unloading it) - 9x2klbr (author - Diamond),
|
||||
supports FAT32 and NTFS.
|
||||
4) Usage of the loader GRUB. Place the file 'memdisk' to the folder 'boot'
|
||||
or to the partition used for Kolibri.
|
||||
a) For GRUB2, in the folder /etc/grub.d add to one of files next lines:
|
||||
|
||||
menuentry 'KolibriOS' {
|
||||
linux16 (hd[Hard disk number],[partition number])[path]/memdisk
|
||||
initrd16 (hd[Hard disk number],[partition number])[path]/kolibri.img
|
||||
}
|
||||
|
||||
example:
|
||||
|
||||
menuentry 'KolibriOS' {
|
||||
linux16 (hd0,msdos1)/boot/memdisk
|
||||
initrd16 (hd0,msdos1)/boot/kolibri.img
|
||||
}
|
||||
|
||||
then, run in terminal 'sudo update-grub'.
|
||||
|
||||
b) For old GRUB, add to the configuration file 'menu.lst' next lines:
|
||||
|
||||
title KolibriOS
|
||||
kernel (hd[Hard disk number],[partition number])[path]/memdisk
|
||||
initrd (hd[Hard disk number],[partition number])[path]/kolibri.img
|
||||
|
||||
Remember that numeration in GRUB starts from 0. Example:
|
||||
|
||||
title KolibriOS
|
||||
kernel (hd0,0)/boot/memdisk
|
||||
initrd (hd0,3)/kolibri/kolibri.img
|
||||
|
||||
III. Install to USB-Flash-drive.
|
||||
The special loader for FAT32-volumes has been written, it and its installer
|
||||
to flash drive can be found in the folder HD_load\USB_Boot.
|
||||
For not-FAT32 drives you may use article placed in the folder
|
||||
HD_load\USB_Boot_old.
|
||||
|
||||
IV. Install to CD and DVD.
|
||||
There exists special LiveCD-version of Kolibri, which contains
|
||||
in addition to standard things some "heavy" (in Kolibri standards) programs:
|
||||
the ported emulator DosBox, games "Fixed Rate Pig" and "sokoban".
|
||||
You can also create bootable CD or DVD on the base of kolibri.img, adding
|
||||
anything what you want, in the mode of floppy emulation.
|
||||
The appropriate actions are determined by used CD/DVD write program
|
||||
(focus on words such as "boot floppy emulation").
|
||||
@@ -1,94 +0,0 @@
|
||||
Control keys in KFar.
|
||||
For panels:
|
||||
arrows, Home, End - move cursor on active panel
|
||||
Tab - change active panel
|
||||
Enter - enter to folder or run program under cursor
|
||||
F3 - view file under cursor
|
||||
F5 - copy selected items or item under cursor to another panel
|
||||
Shift+F5 - copy selected items or item under cursor to the same panel
|
||||
(of course, you must specify another file name)
|
||||
F7 - create folder
|
||||
F8 - delete selected elements or element under cursor
|
||||
F10 - exit
|
||||
Alt+F1/Alt+F2 - change drive on left/right panel
|
||||
Alt+F9 - resize window to maximum possible size and restore initial size
|
||||
Ctrl+F3 - sort file/folders on active panel by name
|
||||
Ctrl+F4 - sort by extension
|
||||
Ctrl+F5 - sort by date/time of last modification
|
||||
Ctrl+F6 - sort by size
|
||||
Ctrl+F7 - don't sort (display in order as on disk)
|
||||
Ctrl+F8 - sort by date/time of creation
|
||||
Ctrl+F9 - sort by date/time of last access
|
||||
F12 - display screens menu
|
||||
Ctrl+R - refresh active panel
|
||||
Menu - display context menu for file under cursor
|
||||
LeftCtrl+1/2/3/4 - select panel mode (brief/medium/full/wide)
|
||||
RightCtrl+0..9 - go to folder specified in the section [FolderShortcuts]
|
||||
of ini-file as Shortcut0..9 accordingly
|
||||
Insert - select/deselect current element
|
||||
Grey[+] - select files and folders with mask
|
||||
Grey[-] - deselect files and folders with mask
|
||||
The mask is like "*.asm,*.inc|template.asm" (which selects all files with
|
||||
extensions ASM and INC except for template.asm): one or more elementary
|
||||
including masks with standard mean of '*' and '?', delimited by ',' or ';',
|
||||
optionally followed by '|' and one or more elementary excluding masks.
|
||||
The mask "*.*" specifies all files having '.' in name (i.e. files with
|
||||
any non-empty extension); to specify all files use "*".
|
||||
Grey[*] - invert selection
|
||||
Alt+<letter or digit> - position cursor on name of file/folder,
|
||||
beginning from selected letter or digit; it shows fast find window,
|
||||
in which one can enter subsequent symbols of file/folder name to more precise
|
||||
selection, and also Ctrl+Enter/Shift+Ctrl+Enter to move to the next/previous
|
||||
panel item, whose name starts with specified letters
|
||||
|
||||
For viewer:
|
||||
Esc = F3 = F10 = Numpad5 - exit
|
||||
Down - line down
|
||||
PgDn - page down
|
||||
Up - line up
|
||||
PgUp - page up
|
||||
Home - to begin of file
|
||||
End - to end of file
|
||||
Left - character left
|
||||
Right - character right
|
||||
Ctrl+Left - in Text-mode 20 characters left;
|
||||
in Hex-mode 1 byte left
|
||||
Ctrl+Right - in Text-mode 20 characters right;
|
||||
in Hex-mode 1 byte right
|
||||
Ctrl+Shift+Left - start of lines on the screen
|
||||
Ctrl+Shift+Right - end of lines on the screen
|
||||
F2 - toggle line wrap
|
||||
F4 - toggle Text <-> Hex mode
|
||||
F8 - toggle encoding cp866 (DOS) <-> cp1251 (Win)
|
||||
Shift+F8 - encoding tables menu
|
||||
F12 - display screens menu
|
||||
F7 - search a string from the current position in the file
|
||||
(the string and settings are set in the following dialog)
|
||||
Shift+F7 - continue to search a string
|
||||
(use the string and settings from last search by F7)
|
||||
Alt+F9 - resize window to maximum possible size and restore initial size
|
||||
|
||||
For editor:
|
||||
Esc = F10 - exit; if the file was modified, the question about save necessity
|
||||
will follow
|
||||
Shift+F10 - save and exit
|
||||
F2 - save the file
|
||||
Down - move cursor down to one line
|
||||
PgDn - move cursor down to one page
|
||||
Up - move cursor up to one line
|
||||
PgUp - move cursor up to one page
|
||||
Left - move cursor left to one symbol
|
||||
Right - move cursor right to one symbol
|
||||
Home - move cursor to the beginning of the current line
|
||||
End - move cursor to the end of the current line
|
||||
Backspace - delete the symbol before the cursor
|
||||
Del - delete the symbol under the cursor
|
||||
Ins - toggle insert/replace mode when entering symbols
|
||||
F12 - display screens menu
|
||||
Alt+F9 - resize window to maximum possible size and restore initial size
|
||||
F7 - search a string starting from the position next to the cursor
|
||||
(the string and search settings are prompted in the following dialog)
|
||||
Shift+F7 - continue to search a string (same as F7 without settings dialog)
|
||||
|
||||
diamond
|
||||
mailto:diamondz@land.ru
|
||||
@@ -1,212 +0,0 @@
|
||||
Introduction.
|
||||
|
||||
mtdbg is a debugger for Kolibri operating system. This documentation describes
|
||||
debugger features and work with it. Feel free to ask on our board (mostly
|
||||
in Russian, but has an English forum) -- board.kolibrios.org.
|
||||
|
||||
General description.
|
||||
|
||||
In each moment of time mtdbg can debug only one program. I will call it
|
||||
loaded program. If no program is loaded, overwhelming majority of debugging
|
||||
actions is disabled.
|
||||
|
||||
mtdbg is controlled by command line, entering from keyboard. Command line
|
||||
is drawn in the bottom part of debugger window. Debugger handles standard
|
||||
input keys Backspace,Delete,Home,End,left/right arrows.
|
||||
Commands are case-insensitive. Delimiter is arbitrary nonzero number of spaces.
|
||||
|
||||
At any moment mtdbg can be terminated by command "quit" (without arguments).
|
||||
You can also simply press to close button in the right upper corner of window.
|
||||
|
||||
When debugger is started without command string parameters, no program is
|
||||
loaded. Also mtdbg can be started with command string, in this case it tries
|
||||
to load program with the name pointed to in first parameter in command string
|
||||
and parameters pointed to following (if present).
|
||||
|
||||
If no program is loaded, you can load a program with the command
|
||||
load <full name of executable file> [<parameters>]
|
||||
Examples:
|
||||
load /sys/example
|
||||
LOAD /sys/aclock w200 h200
|
||||
LoaD /hd0/1/menuetos/dosbox/dosbox
|
||||
All that stays after first space after executable file name, is exactly passed
|
||||
to program as command string.
|
||||
The command "load" reports result in the messages window (a little higher
|
||||
than command line window). If program was loaded successfully, there will
|
||||
be the appropriate message; otherwise the message will contain error reason.
|
||||
Most probable error is "file not found" if wrong file name is given.
|
||||
|
||||
The debugger can load files with information on symbols in the program
|
||||
(labels, global variables) - text files, each line of which has format
|
||||
0x<hex_value_of_addr> <name>
|
||||
(lines, which do not have such format, are ignored). Such file can be created
|
||||
by hand or generated automatically by fasm. Evident load can be done by command
|
||||
load-symbols <full name of symbols file>
|
||||
Furthermore, when the debugger executes the command "load", it checks for
|
||||
presence of file with name as of loading binary and extension '.dbg'
|
||||
(/sys/example.dbg in the first of examples above), and if such file exists,
|
||||
the debugger loads it automatically (with the message "Symbols loaded", if
|
||||
all is OK).
|
||||
|
||||
It can happen so that loaded program is packed. General principle of
|
||||
program packing is following: at first input file is packed (by some
|
||||
pack algorithm), then is appended small code which gets control at program
|
||||
start, unpacks input code in the memory and then passes control to it.
|
||||
If program is packed, it "real" code is not visible and for debugging it is
|
||||
needed previously to pass through unpacker code.
|
||||
mtdbg determines most of existing packers (mxp,mxp_lzo,mxp_nrv,mtappack)
|
||||
and in this case suggests to automatically go to "real" code. It is recommended
|
||||
to accept (press 'y' or <Enter>), but you can refuse too. At refusal and if
|
||||
program is packed by something unknown the command "unpack" (without arguments)
|
||||
can be used. Call it only in the case when you are sure that program is packed
|
||||
and control has not already went to main code! [Starting from Kolibri 0.6.5.0,
|
||||
this paragraph is no more actual, because one can pack applications as all
|
||||
binary files with kpack and the unpacker code in this case is located in the
|
||||
kernel and is transparent for debug.]
|
||||
|
||||
Loaded program can be terminated by the command "terminate" (without
|
||||
arguments). The command "detach" (without arguments) detaches from program,
|
||||
after that program continues execution normally, as if there was no debugger.
|
||||
After both this commands program stops to be debugged.
|
||||
|
||||
It is possible to anew load program for debugging by the command "reload"
|
||||
(without arguments). If there is already loaded program, it is terminated
|
||||
and new instance is started (from the beginning) (with the same command
|
||||
string), in this case the command is similar to the commands
|
||||
terminate
|
||||
load <last program name> <last program arguments>
|
||||
Otherwise is loaded anew latest program, which was debugged (in the current
|
||||
seance of work with mtdbg) (with the same command string), i.e. is similar to
|
||||
load <last program name> <last program arguments>,
|
||||
but the command "reload" in both cases is shorter and more convenient;
|
||||
moreover, "load" thinks that new program is loaded and moves data window
|
||||
(see below) to zero address, and "reload" keeps current address.
|
||||
|
||||
The command "help", which can be shorten to "h", is always available.
|
||||
All commands are divided on groups.
|
||||
"help" without arguments displays the list of command groups.
|
||||
"help" with group name displays the list of commands in this group with short
|
||||
comments.
|
||||
"help" with command name displays information about given command.
|
||||
Examples:
|
||||
help
|
||||
help control
|
||||
h LoaD
|
||||
|
||||
The debugger window consists from the following items enumerated from up
|
||||
to down:
|
||||
- status string. If there is loaded program, shows its name and state
|
||||
("Running/Paused"), otherwise reports "No program loaded".
|
||||
- registers window - shows values of general-purpose registers, register eip
|
||||
and states of single flags: CF,PF,AF,ZF,SF,DF,OF: if flag is cleared, then
|
||||
is displayed lower-case letter, if flag is set, then upper-case one.
|
||||
Registers which are changed from previous moment are highlighted in green.
|
||||
- data window (dump window) - shows memory contains of loaded program
|
||||
- code window (disassembler window) - shows program code as disassembled
|
||||
instructions
|
||||
- messages window
|
||||
- command line window
|
||||
|
||||
Dump window can display data starting from any address, to this serves
|
||||
the command
|
||||
d <expression>
|
||||
The command "d" without arguments flicks dump window down.
|
||||
The same is for code window and the command
|
||||
u <expression>
|
||||
or simply "u".
|
||||
Examples:
|
||||
d esi - displays data at address esi (e.g. is useful before execution of
|
||||
instruction rep movsb)
|
||||
d esp - displays stack
|
||||
u eip - disassembles instruction starting from the current
|
||||
|
||||
Expressions in mtdbg can include
|
||||
- hexadecimal constants
|
||||
- names of all general-purpose registers (8 32-bits, 8 16-bits and
|
||||
8 8-bits) and register eip; values of 16- and 8-bits registers are padded
|
||||
with zeroes to 32 bits
|
||||
- four arithmetic operations +,-,*,/ (with standard priorities) and
|
||||
brackets
|
||||
- [if symbols information was loaded] names, loaded from dbg-file
|
||||
All calculations are realized modulo 2^32.
|
||||
Examples of expressions:
|
||||
eax
|
||||
eip+2
|
||||
ecx-esi-1F
|
||||
al+AH*bl
|
||||
ax + 2* bH*(eip+a73)
|
||||
3*esi*di/EAX
|
||||
The command
|
||||
? <expression>
|
||||
calculates value of specified expression.
|
||||
|
||||
Values of registers in loaded program can be changed by the command "r", which
|
||||
has two absolutely equivalent forms:
|
||||
r <register> <expression>
|
||||
r <register>=<expression>
|
||||
(in both cases you can place spaces as you want). Register can be any of
|
||||
above-mentioned - 24 general-purpose registers and eip.
|
||||
|
||||
|
||||
Let us assume that the command "load" was successfully load program for
|
||||
debugging.
|
||||
Immediately after loading program is suspended and does not execute.
|
||||
Press Ctrl+F7 (command-line analog is the command "s") to make one step
|
||||
in loaded program, after that control returns to debugger which displays
|
||||
new contains of registers and memory. The system call "int 40h" is considered
|
||||
as one step.
|
||||
Pressing Ctrl+F8 (command-line analog is the command "p") also makes step in
|
||||
loaded program, but procedure calls, string operations with prefix
|
||||
rep/repz/repnz and 'loop' cycles are executed as one step.
|
||||
The one-step commands are used usually on single program sections,
|
||||
when it is needed, for example, to regularly trace registers value and/or
|
||||
some variables in memory.
|
||||
The command
|
||||
g <expression>
|
||||
resumes program execution and waits until control goes to eip=given address,
|
||||
and in this moment suspends program. The command "g" without arguments
|
||||
simply resumes execution.
|
||||
|
||||
To suspend program use the command "stop" (without arguments).
|
||||
|
||||
In the typical situation it is required that program is executed normally,
|
||||
but when some conditions are satisfied, program suspends and debugger receives
|
||||
control. The corresponding conditions are called breakpoints or simply breaks.
|
||||
Primary type of breakpoints is to concrete address, i.e. stop execution at
|
||||
eip=<given value>. Such breakpoints are set by the command
|
||||
bp <expression>
|
||||
Note that if there is only one such breakpoint, there is more convenient to use
|
||||
the command "g" with argument instead.
|
||||
|
||||
Other type of breakpoints is on access to given memory area. Maximum
|
||||
numbers of such breakpoints is 4 (because hardware features of x86 processors
|
||||
are used and they allows only 4).
|
||||
bpm <expression> - breaks at any access to byte at given address
|
||||
bpm w <expression> - breaks at write to byte at given address
|
||||
bpmb,bpmw,bpmd <expression> - breaks to access correspondingly to byte, word
|
||||
or dword at given address. bpm <20> bpmb are synonyms. When bpmw,bpmd are used,
|
||||
address must be aligned according to correspondingly word bound (i.e. be even)
|
||||
or dword bound (i.e. be divisible by 4).
|
||||
bpmb,bpmw,bpmd w <expression> - similar to break on write.
|
||||
|
||||
To see the list of set breakpoints use the command "bl", to obtain information
|
||||
on concrete breakpoint use "bl <number>". Unnecessary breakpoints can be
|
||||
deleted with the command "bc <number>", temporarily unnecessary can be
|
||||
disabled by the command "bd <number>", when they will be needed again,
|
||||
use the command "be <number>".
|
||||
|
||||
Remarks.
|
||||
|
||||
1. When debugging your own programs you can put in code instructions
|
||||
int3 (pay attention to absence of space!). Such instruction causes
|
||||
exception at normal run, which leads to process termination, but
|
||||
at work under debugger it is simply activated (with the message
|
||||
"int3 command at xxx"). This feature allows to not think about addresses
|
||||
to use in the commands g and/or bp.
|
||||
2. All output and all input is oriented on hexadecimal scale of notation.
|
||||
3. When program is executed, registers and data window shows information
|
||||
regarding to moment before resume; you can not set registers value in this
|
||||
mode. Nevertheless the command "d" in this mode shows information that
|
||||
was true in the moment of command delivery.
|
||||
|
||||
diamond
|
||||
@@ -1,26 +0,0 @@
|
||||
OpenDialog - file open dialog:
|
||||
1) Move the cursor inside the panel:
|
||||
a) up and down arrows (including add. keyb.) - move the cursor one position up or down.
|
||||
b) PageUp - list page up.
|
||||
c) PageDown - list page down.
|
||||
d) Home - move to the top of directory.
|
||||
e) End - move to the end of directory.
|
||||
2) Enter - operations with the selected file:
|
||||
a) enter the folder.
|
||||
b) choose a file.
|
||||
3) Using the menu:
|
||||
Alt+F1 - call disk selection menu.
|
||||
Alt+F2 - call sort menu.
|
||||
Alt+F3 - call filter menu.
|
||||
Inside the menu:
|
||||
Arrow cursor up and down - move to item.
|
||||
Esc - close the window.
|
||||
Enter - close the window with confirmation.
|
||||
Arrow cursor left and right - move into the adjacent menu.
|
||||
4) Ctrl+R - update the contents of a directory.
|
||||
5) Backspace - exit from the directory.
|
||||
6) Insert - highlighted by red color the file at the cursor and move the cursor one position down.
|
||||
7) Ctrl+A and Ctrl+(NumPad(+) Up) - select all files and directories in the active panel, with the exception of the directory '..'
|
||||
8) Ctrl+(NumPad(-) Up) - deselect all files and directories in the active panel with the exception of the directory '..'
|
||||
9) Ctrl+(NumPad(*) Up) - invert the selection of all files and directories in the active panel, with the exception of the directory '..'
|
||||
10) Esc - shutdown the program, without opening of a file.
|
||||
@@ -11,14 +11,14 @@ else env_prefix = "DOCDIR=$(DOCDIR) "; cp_cmd = "cp %f %o"
|
||||
end
|
||||
if tup.getconfig("LANG") == "ru_RU"
|
||||
then tup.append_table(deps,
|
||||
tup.rule("../../../../kernel/trunk/docs/sysfuncr.txt", "iconv -f utf-8 -t cp866 %f > %o", "SYSFUNCR.TXT"))
|
||||
tup.rule("../../../../kernel/trunk/docs/sysfuncr.txt", "iconv -f utf-8 -t cp866 %f > %o", "SysFuncr.txt"))
|
||||
else tup.append_table(deps,
|
||||
tup.rule("../../../../kernel/trunk/docs/sysfuncs.txt", cp_cmd, "SYSFUNCS.TXT"))
|
||||
tup.rule("../../../../kernel/trunk/docs/sysfuncs.txt", cp_cmd, "SysFuncs.txt"))
|
||||
end
|
||||
tup.append_table(deps,
|
||||
tup.rule("../../../develop/fasm/1.73/fasm.txt", cp_cmd, "FASM.TXT")
|
||||
tup.rule("../../../develop/fasm/1.73/fasm.txt", cp_cmd, "Fasm.txt")
|
||||
)
|
||||
tup.append_table(deps,
|
||||
tup.rule("../../../../kernel/trunk/docs/stack.txt", cp_cmd, "STACK.TXT")
|
||||
tup.rule("../../../../kernel/trunk/docs/stack.txt", cp_cmd, "Stack.txt")
|
||||
)
|
||||
tup.rule({"docpack.asm", extra_inputs = deps}, env_prefix .. FASM .. " %f %o " .. tup.getconfig("KPACK_CMD"), "docpack")
|
||||
|
||||
@@ -179,7 +179,7 @@ fileinfo:
|
||||
dd 0
|
||||
dd param
|
||||
dd 0 ,0
|
||||
db '/sys/TINYPAD',0
|
||||
db '/sys/develop/cedit',0
|
||||
|
||||
param db '*'
|
||||
fsize:
|
||||
@@ -191,24 +191,21 @@ embedded:
|
||||
; Please use only filenames w/o path!
|
||||
|
||||
; -- Start of embedding area ------
|
||||
embed_docdir_file 'CREDITS.TXT' ;a
|
||||
|
||||
embed_docdir_file 'Copying.txt' ;a
|
||||
embed_docdir_file 'Hot_Keys.txt' ;b
|
||||
embed_local_file 'Fasm.txt' ;c
|
||||
embed_docdir_file 'Mtdbg.txt' ;d
|
||||
if lang eq ru_RU
|
||||
embed_docdir_file 'GNU.TXT' ;b
|
||||
embed_local_file 'SysFuncr.txt' ;e
|
||||
else ; Default to en_US
|
||||
embed_docdir_file 'COPYING.TXT' ;b
|
||||
embed_local_file 'SysFuncs.txt' ;e
|
||||
end if
|
||||
embed_docdir_file 'HOT_KEYS.TXT' ;c
|
||||
embed_local_file 'FASM.TXT' ;d
|
||||
embed_docdir_file 'MTDBG.TXT' ;e
|
||||
if lang eq ru_RU
|
||||
embed_local_file 'SYSFUNCR.TXT' ;f
|
||||
else ; Default to en_US
|
||||
embed_local_file 'SYSFUNCS.TXT' ;f
|
||||
end if
|
||||
embed_local_file 'STACK.TXT' ;g
|
||||
embed_docdir_file 'KFAR_KEYS.TXT' ;h
|
||||
embed_docdir_file 'INI.TXT' ;i
|
||||
embed_docdir_file 'OPENDIAL.TXT' ;j
|
||||
embed_local_file 'Stack.txt' ;f
|
||||
embed_docdir_file 'KFAR_Keys.txt' ;g
|
||||
embed_docdir_file 'INI.txt' ;h
|
||||
embed_docdir_file 'OpenDial.txt' ;i
|
||||
embed_docdir_file 'Credits.txt' ;j
|
||||
; -- End of embedding area -------
|
||||
|
||||
dd 0
|
||||
|
||||
Reference in New Issue
Block a user