@DATABASE XBase.guide
@AUTHOR "Rafaî Kaczmarczyk"
@(C) "Copyright © 1997 Rafaî Kaczmarczyk"
@$VER: XBase.guide 1.37 (17.7.97)

@WORDWRAP

@NODE MAIN "Dokumentacja do programu XBase wersja 0.43"

                            XBase 0.43 (17.7.97)
                    Copyright © 1997 @{"Rafaî Kaczmarczyk" LINK JA}
                           All rights reserved.

     Ten program podlega "Standard Amiga FD-Software Copyright Note".
     Ten program jest FREEWARE, jak zostaîo to okreôlone w punkcie 4a.
     Jeôli szukasz wiëcej szczegóîów, proszë przeczytaê @{"AFD-COPYRIGHT" LINK "AFD-COPYRIGHT.pl/MAIN"}
     (wersjë 1 lub nowszâ).

                   @{" Wymagania                            " LINK WYMAGANIA}
                   @{" Instalacja na twardym dysku          " LINK INSTALACJA}
                   @{" Uruchamianie programu                " LINK URUCHAMIANIE}
                   @{" Definiowanie projektu                " LINK DEFINIOWANIE}
                   @{" Zapisywanie projektu                 " LINK ZAPISYWANIE}
                   @{" Otwieranie projektu                  " LINK OTWIERANIE}
                   @{" Doîâczanie projektu                  " LINK DOÎÂCZANIE}
                   @{" Poruszanie sië po rekordach          " LINK WYBIERANIE}
                   @{" Wychodzenie z programu               " LINK WYCHODZENIE}
                   @{" Wycinanie rekordu do buforu          " LINK WYCINANIE}
                   @{" Kopiowanie rekordu do buforu         " LINK KOPIOWANIE}
                   @{" Wstawianie rekordu z buforu          " LINK WSTAWIANIE}
                   @{" Dodawanie rekordu                    " LINK DODAWANIE}
                   @{" Kasowanie rekordu                    " LINK KASOWANIE}
                   @{" Przeszukiwanie rekordów              " LINK PRZESZUKIWANIE}
                   @{" Sortowanie rekordów                  " LINK SORTOWANIE}

                   @{" Informacje techniczne                " LINK INFOTECH}
                   @{" Historia programu                    " LINK HISTORIA}
                   @{" Do zrobienia                         " LINK DOZROBIENIA}

@ENDNODE

@NODE JA "Autor"

Autor
~~~~~
Sugestie i informacje o bîëdach proszë kierowaê na mój adres:

                    Rafaî Kaczmarczyk
                   ul. Rogowska  10/22
                     54-440  Wrocîaw

@ENDNODE

@NODE WYMAGANIA "Wymagania"

Wymagania
~~~~~~~~~
Wymagania sprzëtowe:
  - Amiga
  - AmigaOS 2.04 lub nowszy (AmigaOS 2.1, jeûeli chcesz korzystaê
    z katalogów jëzykowych).
  - 0.5 MB RAM

Wymagania programowe:
  - @{"reqtools.library" LINK PRAWA_AUTORSKIE} w wersji 2.0 (38.693) lub nowszej

@ENDNODE

@NODE PRAWA_AUTORSKIE "Prawa autorskie i rozpowszechnianie"

Program  uûywa  biblioteki  reqtools.library,  której  wîaôcicielami   praw
autorskich sâ  Nico  François  (Copyright © 1992-1994)  i  Magnus  Holmgren
(Copyright © 1995-1997).

@ENDNODE

@NODE INSTALACJA "Instalacja na twardym dysku"

Instalacja na twardym dysku
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aby zainstalowaê program na twardym dysku  przenieôê szufladë  programu  do
docelowego  katalogu.  Skopiuj   plik   "XBase/Icons/def_XBaseProject"   do
urzâdzenia logicznego "ENVARC:"

@ENDNODE

@NODE URUCHAMIANIE "Uruchamianie programu"

Uruchamianie programu
~~~~~~~~~~~~~~~~~~~~~
XBasea moûna uruchomiê z workbencha i z shella.
Przy uruchamianiu moûna podaê nastëpujâce argumenty:

  FILE        - Nazwa pliku, który bëdzie automatycznie otwarty zaraz po
                uruchomieniu XBasea (tylko SHELL).

  PUBSCREEN   - Nazwa ekranu publicznego na którym XBase otworzy swoje okno.
                Jeôli program ekranu nie znajdzie okno zostanie otwarte na
                ekranie Workbencha.

  NOICONS     - Wyîâcza zapisywamie ikon dla kaûdego projektu.

Program moûna uruchomiê takûe poprzez klikniëcie na ikonie projektu XBasea.
@ENDNODE

@NODE DEFINIOWANIE "Definiowanie projektu"

Definiowanie projektu
~~~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Projekt/Definiowanie..." w wyniku  czego  otworzy  sië  okno
edycji pól. Gdy chcesz  tworzyê  projekt  od  poczâtku,  a  jest  juû  jest
utworzony projekt to wczeôniej wybierz opcjë "Projekt/Wyczyôê/Projekt...".

Wybierz rozdziaî:
 @{" Tworzenie nowego pola         " LINK NOWEPOLE}
 @{" Zmiana nazwy i atrybutów pola " LINK EDYTOWANIEPOLA}
 @{" Kasowanie pola                " LINK KASOWANIEPOLA}

Gadûet "Akceptuj" zatwierdza dokonane zmiany. Gadûet  ten  jest  nieaktywny
jeôli  nie  utworzyîeô  ûadnego  pola.  Gadûet  "Zaniechaj"   zamyka   okno
i przywraca wczeôniejszy stan pól, takie samo dziaîanie ma gadûet zamykania
okna.

@ENDNODE

@NODE ZAPISYWANIE "Zapisywanie projektu"

Zapisywanie projektu
~~~~~~~~~~~~~~~~~~~~
Jeôli projekt nie byî jeszcze w ogóle zapisywany lub chcesz go zapisaê  pod
nowâ nazwâ wybierz opcjë "Projekt/Zapisz jako..."  i  w  requesterze  wpisz
nazwë pliku. Jeôli plik o podanej nazwie istnieje  juû  na  dysku,  program
zapyta sië czy chcesz zastâpiê ten plik.
Jeôli chcesz zapisaê projekt z nazwâ pod jakâ zostaî otwarty  lub  z  nazwâ
pod jakâ wczeôniej go zapisywaîeô wybierz opcjë "Projekt/Zapisz".

@ENDNODE

@NODE OTWIERANIE "Otwieranie projektu"

Otwieranie projektu
~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Projekt/Otwórz..." i w requesterze wybierz plik do  otwarcia
lub wrzuê ikonë  pliku  do  gîównego  okna  programu.  Jeûeli  w  aktualnym
projekcie dokonaîeô zmian od ostatniego zapisu lub projekt w ogóle nie  byî
zapisywany, pojawi sië requester z proôbâ o potwierdzenie tej opracji.

@ENDNODE

@NODE DOÎÂCZANIE "Doîâczanie projektu"

Doîâczanie projektu
~~~~~~~~~~~~~~~~~~~
Wybierz opcjë  "Projekt/Doîâcz..."  i  w  requesterze  wybierz  plik  który
zostanie doîâczony do aktualnego projektu.

@ENDNODE

@NODE WYBIERANIE "Poruszanie sië po rekordach"

Poruszanie sië po rekordach
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Do poruszania sië po rekordach sîuûâ nastëpujâce klawisze:

  kursor w górë        - poprzedni rekord
  kursor w dóî         - nastëpny rekord
  shift, kursor w górë - pierwszy rekord
  shift, kursor w dóî  - ostatni rekord

Moûna skoczyê do dowolnego rekordu wybierajâc  opcjë  "Rekord/Skocz  do..."
i wpisujâc w requesterze numer rekordu do jakiego chcemy skoczyê.

@ENDNODE

@NODE WYCHODZENIE "Wychodzenie z programu"

Wychodzenie z programu
~~~~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Projekt/Skoïcz..." lub wybierz gadûet zamykania okna. Jeûeli
w aktualnym projekcie dokonaîeô zmian  od  ostatniego  zapisu  lub  projekt
w ogóle nie byî zapisywany, pojawi sië requester z proôbâ  o  potwierdzenie
tej opracji.

@ENDNODE

@NODE WYCINANIE "Wycinanie rekordu do buforu"

Wycinanie rekordu do buforu
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Rekord moûesz wyciâê w celu wstawienia  go  w  innym  miejscu.  Aby  wyciâê
rekord wybierz opcjë "Edycja/Wytnij". Rekord zostanie usuniëty i skopiowany
do buforu. Opcja jest nieaktywna, gdy w projekcie jest tylko jeden rekord.

Zobacz takûe:
  @{" Wstawianie rekordu z buforu  " LINK WSTAWIANIE}
  @{" Kopiowanie rekordu do buforu " LINK KOPIOWANIE}

@ENDNODE

@NODE KOPIOWANIE "Kopiowanie rekordu do buforu"

Kopiowanie rekordu do buforu
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Rekord moûna skopiowaê w celu wstawienia go w innym miejscu. Aby  skopiowaê
rekord  wybierz  opcjë  "Edycja/Skopiuj".  Rekord  zostanie  skopiowany  do
buforu.

Zobacz takûe:
  @{" Wstawianie rekordu z buforu  " LINK WSTAWIANIE}
  @{" Wycinanie rekordu do buforu  " LINK WYCINANIE}

@ENDNODE

@NODE WSTAWIANIE "Wstawianie rekordu z buforu"

Wstawianie rekordu z buforu
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Edycja/Wstaw", program wstawi rekord z buforu  za  aktualnym
rekordem. Opcja jest nieaktywna, gdy w buforze nie ma ûadnego rekordu.

Zobacz takûe:
  @{" Wycinanie rekordu do buforu  " LINK WYCINANIE}
  @{" Kopiowanie rekordu do buforu " LINK KOPIOWANIE}

@ENDNODE

@NODE DODAWANIE "Dodawanie rekordu"

Dodawanie rekordu
~~~~~~~~~~~~~~~~~
Wybierz opcjë "Edycja/Dodaj", program wstawi rekord za aktualnym rekordem.

@ENDNODE

@NODE KASOWANIE "Kasowanie rekordu"

Kasowanie rekordu
~~~~~~~~~~~~~~~~~
Wybierz opcjë "Edycja/Skasuj...". Gdy rekord nie jest pusty to  pojawi  sië
requester  z  proôbâ  o  potwierdzenie  skasowania  rekordu.   Opcja   jest
nieaktywna, gdy w projekcie jest tylko jeden rekord.

@ENDNODE

@NODE PRZESZUKIWANIE "Przeszukiwanie rekordów"

Przeszukiwanie rekordów
~~~~~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Rekord/Znajdú...". Opcja ta jest nieaktywna, gdy w projekcje
jest tylko  jeden  rekord.  Dla  kaûdego  pola  moûesz  wprowadziê  wzorzec
przeszukiwania. Akceptowane sâ wszystkie wzorce AmigaDOSu np.: (Ma#? |Pa#?)
wzorzec ten bëdzie pasowaî  do  wszystkich  wyrazów  zaczynajâcych  sië  na
litery "Ma" i "Pa". Wielkoôci liter  sâ  ignorowane.  Ûeby  dowiedzieê  sië
wiëcej o wzorcach zajrzyj  do  instrukcji  AmigaDOSu.  Program  przeszukuje
projekt od pierwszego rekordu do ostatniego. jest  od  pierwszego  rekordu.
Gadûet  "Wyczyôê"  kasuje  wszystkie  wzorce.  Gadûet  "Znajdú"  rozpoczyna
przeszukiwanie, jest  on  nieaktywny,  gdy  nie  jest  ustawione  kryterium
przeszukiwania.  Gdy  zrezygnowaliômy   z   sortowania   naciskamy   gadûet
"Zaniechaj".
Jeûeli chcesz wznowiê przeszukiwanie  wykorzystujâc  wczeôniej  wprowadzone
wzorce  to  wybierz  opcjë  "Rekord/Znajdú  nastëpny"  lub   "Rekord/Znajdú
poprzedni". W obu przypadkach przeszukiwanie rozpocznie sië  od  aktualnego
rekordu z tâ róûnicâ, ûe w pierwszym przypadku program bëdzie  przeszukiwaî
do przodu czyli od aktualnego rekordu do ostatniego,a w drugim przypadku od
aktualnego rekordu do pierwszego rekordu.
@ENDNODE

@NODE SORTOWANIE "Sortowanie rekordów"

Sortowanie rekordów
~~~~~~~~~~~~~~~~~~~
Wybierz opcjë "Rekord/Sortuj...". Opcja ta jest nieaktywna, gdy w projekcje
jest tylko jeden rekord. Po wybraniu tej opcji  pojawi  sië  okno  z  listâ
wszystkich pól oraz kilkoma gadûetami. Klikajâc myszâ na  kolejnych  polach
lub gadûetem "Pozycja:" okreôlamy kryterium wedîug którego  bëdâ  sortowane
rekordy, np. jeôli mamy projekt skîadajâcy sië z  nastëpujâcych  pól: Imië,
Nazwisko i ustawimy takie kryterium:
Imië                A-Û 2
Nazwisko            A-Û 1
Adres               Û-A 3
to program posortuje rekordy wedîug pola "Nazwisko", ale jeûeli trafiâ  sië
dwa rekordy o takich samych nazwiskach to o kolejnoôci tych dwóch  rekordów
zadecyduje pole "Imië" itd.
Gadûet "Porzâdek:" sîuûy do ustalenia porzâdku sortowania,  A-Û  -  rosnâcy
Û-A - malejâcy. Gadûet ten jest nieaktywny gdy nie jest wybrane ûadne pole.
Gadûet "Sortuj" rozpoczyna sortowanie, jest on  nieaktywny,  gdy  nie  jest
ustawione  kryterium  sortowania.  Gdy  zrezygnowaliômy  z   przeszukiwania
naciskamy gadûet "Zaniechaj" lub gadûet zamykania okna.

@ENDNODE

@NODE INFOTECH "Informacje techniczne"

Informacje techniczne
~~~~~~~~~~~~~~~~~~~~~
Dane zapisywane sâ w dwóch plikach.  W  pierwszym  pliku  przechowywane  sâ
nazwy pól i wszystkie rekordy. Plik  ten  jest  w  formacie  ASCII  (zwykîy
tekst). Struktura tego pliku jest nastëpujâca: pierwsza linia sâ  to  nazwy
pól porozdzielane znakami TAB, pozostaîe linie to  kolejne  rekordy  (jedna
linia to jeden rekord) w których dane porozdzielane sâ  znakami  TAB.  Taki
sposób przechowywania danych umoûliwia eksport i  import  danych  z  prawie
kaûdâ bazâ danych.
Drugi plik jest  w  formacie  XBF  (wîasny  format  zapisu),  w  tym  pliku
przechowywane sâ takie informacje jak rodzaj formatowania  danych  w  polu,
maksymalna dîugoôê pola, dîugoôê widzialna pola.  W  przyszîoôci  bëdâ  tam
takûe przechowywane informacje o rodzaju  pola  (np.  tekstowe,  numeryczne
itp).

Ikonë projektów program pobiera z "ENV: def_XBaseProject", jeûeli  jej  tam
nie znajdzie to pobiera domyôlnâ ikonë dla plików typu project.

@ENDNODE

@NODE HISTORIA "Historia programu"

Historia programu
~~~~~~~~~~~~~~~~~
0.43 (17.07.97 godz. 23:27:38)
  - Zlikwidowanie tooltypeu SIZEGADGET.
  - Zlikwidowanie niewykorzystywanych gadûetów w oknie definiowania pól.
  - Zastâpienie opcji "Projekt/Nowy..." przez "Projekt/Wyczyôê/Projekt..."
    i "Projekt/Wyczyôê/Dane...".
  - Moûna teraz okreôliê dîugoôê widzialnâ pola, a nie tylko maksymalnâ.
  - Zastâpienia suwaka do okreôlania dîugoôci pola gadûetem typu INTEGER.
  - Dodanie opcji doîâczania projektów.

0.42 (01.07.97)
  - Pierwsze wydanie

@ENDNODE

@NODE DOZROBIENIA "Do zrobienia"
@NEXT MAIN

Do zrobienia
~~~~~~~~~~~~
  - róûne rodzaje pól (tekstowe, numeryczne itp)
  - port arexxa
  - obsîuga systemowego clipboardu
  - online help

@ENDNODE

@NODE NOWEPOLE "Tworzenie nowego pola"
@PREV TWORZENIE

Tworzenie nowego pola
~~~~~~~~~~~~~~~~~~~~~
Nazwë nowego pola wpisujesz w polu tekstowym znajdujâcym sië  pod  gadûetem
z listâ utworzonych pól. Po wpisaniu nazwy moûesz okreôliê  sposób  w  jaki
bëdzie wyrównywany tekst w polu. Do tego celu sîuûy gadûet "Wyrównuj:".  Sâ
trzy sposoby wyrównywania  tekstu:  wyrównywanie  do  lewej  krawëdzi  pola
(pozycja w gadûecie "Do lewej"), centrowanie (pozycja w gadûecie "Centruj")
oraz wyrównywanie do prawej krawëdzi pola (pozycja w gadûecie "Do prawej").
Suwakiem "Pozycja:" moûesz ustawiê pozycjë na której znajdzie sië nowe pole
w liôcie.
W gadûecie "Dîugoôê maksymalna:" moûesz  wpisaê  maksymalnâ  iloôci  znaków
(1-200) jakâ bëdzie moûna wpisaê do pola. Gadûet "Dîugoôê widzialna:" sîuûy
do okreôlenia szerokoôci ramki pola.
Do  poruszania  sië  pomiëdzy  polami  "Dîugoôê  maksymalna:",  "Dîugoôê   
widzialna:" oraz polem do  wpisywania  nazwy  sîuûy  klawisz  TAB.  W  celu
dodania pola do listy naciônij gadûet "Dodaj",  klawisz  RETURN  lub  ENTER
jeûeli zaô rozmyôliîeô sië  to  naciônij  gadûet  "Nowe",  który  przywróci
standardowe ustawienia. Gadûet  "Dodaj"  jest  nieaktywny,  gdy  nic  nie  
wpisaîeô do gadûetu tekstowego. Gadûet "Nowe" jest nieaktywny, gdy nic  nie
zmieniîeô w gadûetach.

@ENDNODE

@NODE EDYTOWANIEPOLA "Zmiana nazwy i atrybutów pola"

Zmiana nazwy i atrybutów pola
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Naciônij na nazwie pola, którego chcesz zmieniê, nazwa tego  pola  zostanie
podôwietlona,  a  w  gadûecie  tekstowym  pojawi  sië  jego  nazwa.  Sposób
postëpowania  przy  zmianie  ustawieï pola  jest  identyczny  jak  przy
@{"tworzeniu nowego pola" LINK NOWEPOLE}.

@ENDNODE

@NODE KASOWANIEPOLA "Kasowanie pola"
@NEXT MODYFIKOWANIE

Kasowanie pola
~~~~~~~~~~~~~~
Zaznacz pole do skasowania oraz naciônij gadûet "Skasuj", gadûet  ten  jest
nieaktywny, gdy nie jest wybrane ûadne pole lub gdy  zaznaczone  pole  jest
jedynym polem w projekcie.

@ENDNODE
