Otwieraj plik pod edytorem DOS
 <-------------------------------------------------------------------------->

۱
   
                    ۱                   
                                                 
                                                 
                                                  
                                           
                                                   
                                                   
                                                   
   ۱                     ۱                 
   ۱                                                                 
                  --->>> TURBO MASZYNOWY v.3.0 <<<---                    
                     --->>> coding by AJOT <<<---                        
                  --->>> copyright SENTINEL 2000-2003 <<<---


 <-------------------------------------------------------------------------->

--->>> UWAGA!!!

   Program nie jest zapak i nie mona przekazywa lub sprzedawa obojtnie
komu za darmo czy za pienidze. Wszelkie czerpanie zyskw z tego programu
jest zabronione nie dotyczy to autora programu, ktremu naley si co zarobi
Autor nie odpowiada za wieszanie si programu i nie zwraca adnych kosztw
poniesionych z powodu naprawy maszyn.
Przed rozpoczciem instalacji upewnij si, e posiadasz podan poniej
konfiguracj sprztow.
Ostrzegam, e nie testowaem tego programu na innym sprzcie ni z podan
niej konfiguracj.
   Autor programu bdzie odpowiada na wszelkie uwagi i zastrzeenia tylko
i wycznie po podaniu numeru seryjnego programu, w ktry zostaje wyposaony
uytkownik wraz z nabyciem programu.
   Po nabyciu programu naley wypeni kart rejestracyjn i przesa
do autora pod wskazany adres na kocu tego pliku. Nie przesanie karty
rejestracyjnej bdzie traktowane jako nabycie pirackiej wersji programu
i wszelkie roszczenia z powodu nieprawidowego funkcjonowania programu
nie bd uwzgldniane.
   W wypadku nadejcia kilku jednakowych zgosze programu z tym samem numerem
seryjnym bdzie uwzgldniana ta, ktra bdzie posiadaa wczeniejsz dat
pieczci pocztowej.

 <-------------------------------------------------------------------------->

--->>> Wymagania sprztowe:

 Procesor      - typ 80486
 Memory        - na 64 MB dziaa (gdyby, co zawsze mona wyczy WINDOWS)
 Koprocesor    - obecny
 Karta grafiki - VGA lub kompatybilna
 DOS (version) - 5 i wicej (konieczny, HIMEM.sys)
 Mouse         - wasza sprawa
 Pami DOS    - 128 KB (tyle to na TM a jak co chcecie odpali to wicej)

 <-------------------------------------------------------------------------->

--->>> Spis plikw pojawiajcych si po instalacji:

TM.com     - ten program naley uruchamia
TM.dll     - biblioteka programu
TM.hlp     - plik pomocy dla kadego
TM.ini     - no gdzie musz zapisa wasze ustawienia
Nowy.tm    - plik zawierajcy szablon dla opcji PLIK/NOWY -moliwa modyfikacja
ReadMe.txt - wanie czytasz
Kody.txt   - spis kodw uywanych do programowania (a przynajmniej w tym
             edytorze), plik nie bdzie w wersjach dyskietkowych

 <-------------------------------------------------------------------------->

--->>> Typowa obsuga programu:

   Program mona obsugiwa za pomoc myszki najedajc na odpowiednie
funkcje programu i klikajc jednokrotnie. Jeeli nie mamy do dyspozycji
myszki to mona posugiwa si klawiatur. Podpowiedzi co do obsugi
klawiatur znajduj si na dolnej belce programu. Jeeli chcemy wywoa
funkcje znajdujce si w grnej belce naley przycisn lewy ALT a nastpnie
posugujemy si klawiszami kursora i klawiszem ENTER. W oknach aby zmieni
funkcj posugujemy si klawiszem TAB, zatwierdzenie funkcji nastpuje
poprzez klawisz ENTER i SPACE. W kadej chwili mona wybra klawisz F1
ktry wywietli nam pomoc dotyczc wybieranych funkcji.

 <-------------------------------------------------------------------------->

--->>> Klawisze skrtw dostpne w menu edycyjnym:

  F1     - Pomoc
  F2     - Zapisz plik
  F3     - Otwrz plik
  F4     - Drukuj
  F5     - Powtrz ostatnie wyszukiwanie
  F6     - Skocz do linii
  F7     - Informacje
  F8     - Wiersz wejciowy
  F9     - Kompilacja programu
  F10    - Zakoczenie programu
  F11    - Przecza przemiennie midzy edytorem kodu maszynowego a edytorem
           tekstu
  F12    - wywietla dziennik kompilacji
  CTRL+K - Kopiuj
  CTRL+W - Wklej

 <-------------------------------------------------------------------------->

--->>> Wskazwki i porady, (czyli atwiej i prociej):

- jeeli chcesz uzyska pomoc na temat komendy CMPXCHG to nie szukaj tego
  w menu POMOC, atwiej bdzie ustawi kursor na tej komendzie i wcisn
  klawisz F1.
- aby programy szybciej si kompiloway wycz w menu OPCJE/USTAWIENIA funkcj
  sprawdzaj dublowanie si nazw adresw.
- pamitaj podczas przeczania si w menu WIDOK program zapyta si lub te
  automatycznie zapisze ostatnie zmiany w edytowanym pliku.
- w pomocy dostpnej w programie uywa si nastpujcych oznacze dla rejestru
  flagowego (FLAGS):
  OF - Overflow flag;
  DF - Direction flag;
  IF - Interrupt enable flag;
  TF - Trap flag;
  SF - Sign flag;
  ZF - Zero flag;
  AF - Auxiliary flag;
  PF - Parity flag;
  CF - Carry flag;

 <-------------------------------------------------------------------------->

--->>> Cenne uwagi podczas programowania:

- zapisywanie nazw segmentw i adresu naley przeprowadzi w nastpujcy
  sposb:
   SEGMENT NAME 'dane_txt' ;nazwa segmentu
   :komunikat ;nazwa adresu
  zapis w odwrotnej kolejnoci moe przynie dziwne efekty.
- pojawiajce si pliki nieznanego pochodzenia. Po uruchomieniu programu TM
  jest tworzony plik ukryty tymczasowy o bliej nie okrelonej nazwie
  w katalogu, w ktrym jest zainstalowany sam program. Program podczas
  kompilacji tworzy rwnie pliki pomocnicze w katalogu, w ktrym jest
  edytowany plik i s to pliki z rozszerzeniem:
  *.tm1, *.tm2, *.tm3, *.tm4, *.tm5, *.tm8, *.tm9, *.txt
  - gdzie * oznacza nazw edytowanego pliku, oprcz tego jest
  tworzony plik rdowy. Podczas bdnej kompilacji moe si okaza, e
  wymienione pliki nie zostay usunite - naley je wtedy samemu usun lub
  te pozostawi a kompilator po poprawnej kompilacji sam je usunie.
- podczas uywania komendy DB (.byte) naley wzi pod uwag sytuacj, e
  jeeli zostanie zapisana cyfra $1234 to kompilator potraktuje j jako
  warto WORD natomiast cyfra $123456 zostanie potraktowana jako DWORD,
  wartoci wiksze ni DWORD nie zostan rozpoznane i zostanie wywietlony
  bd. Ponowne zachowanie ma rozkaz DW (.word). Nie ma natomiast moliwoci
  aby komendy DW, DD, DQ potraktoway liczb $10 jako rozkaz DB.
- komendy DD i DQ nie rozpoznaj i nie obsuguj komendy SEGMENT,
  natomiast komenda DQ nie rozpoznaje i nie obsuguje nazw mnemonikw.
- zapis komendy typu: MOV BYTE PTR [BX+SI] -naley zwrci uwag, aby midzy
  BYTE PTR by tylko jeden znak odstpu w przeciwnym wypadku komenda moe
  zosta potraktowana bdnie.
- podczas tworzenia wasnych bibliotek lub ich uywania naley wzi pod
  uwag nastpujce sytuacje:
  1. kada biblioteka jest napisana w ten sposb, aby mona byo jej uywa
     zarwno do plikw COM jak i EXE;
  2. procedury zawarte w bibliotekach s tak pisane, e po ich zakoczeniu
     uytkownik sam moe zdecydowa o tym jak odbdzie si powrt tzn.:
                 segment name 'dopalacz_C'
                 .tm "c:\tm\tm(bib)\dop_C.tm"
                 retf ; jeeli bdzie uyta w innym segmencie
                 ret  ; jeeli bdzie uyta w tym samym segmencie
                 iret ; jeeli bdzie uyta jako przerwanie
     Tak opisane biblioteki pozwalaj na modyfikacj np. znacznikw FLAGS
     ktre podczas wywoania przerwania znajduj si na stosie;
  3. w wszystkich bibliotekach napisanych przez autora programu w nazwach
     mnemonikw zosta zastosowany pewien standard tzn.:
      :_xxx jmp :_xxxx
     dlatego te nie zaleca si uywania znaku "_" w wasnych programach
     jako pierwszego znaku po dwukropek gdy moe spowodowa to konflikt
     adresw.



 <-------------------------------------------------------------------------->

--->>> Uwagi instalacyjne

   Poniewa nie posiadam zgody na rozpowszechnianie jakichkolwiek plikw
nie stworzonych przeze mnie, dlatego te podczas tworzenia dyskietki startowej
instalator bdzie musia skorzysta z plikw znajdujcych si na dyskietce
Przygotowanej przez uytkownika.
   Aby przygotowa dyskietk naley wykona nastpujce operacje:
   - sformatuj dyskietk wraz z tworzeniem plikw systemowych
   - skopiuj do katalogu gwnego pliki: himem.sys oraz mouse.com
   - uruchom instalatora Turbo Maszynowy

 <-------------------------------------------------------------------------->

--->>> HISTORIA

 v.3.0 - jest to pierwsza wersja, ktra wylduje nie tylko w moim sprzcie,
         co w niej ulepszono? WSZYSTKO!!!
         Program posiada wikszo niezbdnych funkcji do edycji w jzyku
         maszynowym jak i rwnie pracy nad plikami tekstowymi.
         Wersja ta zostaa w porwnaniu do poprzedniej wyposaona w edytor
         kodu ASCII (zwyky edytor tekstowy) oraz moliwo podgldu efektw
         kompilacji. Program dodatkowo zosta wyposaony w plik TM.hlp
         co oznacza, e pojawia si POMOC.
         W porwnaniu do poprzedniej wersji program obsuguje wszystkie
         kody i rejestry procesorw 80486.
         Kompilator umoliwia rwnie kompilowanie do plikw EXE.
         Podczas pisania tej wersji nawet monitor szybciej zacz pracowa
         i wyskoczy mi z niego siwy dym.

 v.2.0 - od tej wersji programu nareszcie zosta poczony edytor razem
         z kompilatorem, co znacznie uatwia prac. Dopracowaem te obsug
         kodw (w v.1.0 kompilator nie kompilowa np.: mov byte ptr [bx]).
         Ponadto program mona obsugiwa myszk no i oczywicie pojawio si
         menu z kilkoma opcjami niezbdnymi do edycji programw.
         Program jak na razie nie posiada opcji pomocy, lecz mam nadziej,
         e ju wkrtce uda mi si to zmieni.

 v.1.0 - program zosta napisany w Turbo Pascal'u dlatego te nie wydaje si
         by wystarczajco atrakcyjny, lecz niestety zmusiem si do jego
         napisania po nieustajcych probach moich kumpli i nie tylko
         o zdobycie jakiego Turbo Asemblera. Mam nadziej, e za pomoc
         tego programu uda mi si napisa nowsz wersj, ktra w porwnaniu
         do tej bdzie miaa takie moliwoci jak przynajmniej zwyky edytor
         jzykw wysokiego poziomu.

 <-------------------------------------------------------------------------->

 To by byo na tyle...
 - nie zapomnij przesa karty rejestracyjnej na podany adres...

                                                              opracowa AJOT
                                                              Artur JAMROY
                                                              ul. ?????????
                                                           41-200 Sosnowiec
                                                                     POLAND

                                                  @-mail: AJOT74@plusnet.pl
                                        copyright SENTINEL 2000-2003 & 2012
                                                     www.polstronki.ovh.org

 <-------------------------------------------------------------------------->

