@database Searcher.guide @author "LeMUr of blabla" @(c) 1997 LeMUr/blabla @$VER: Searcher.guide (5.09.97) @node main "Searcher manual - main menu" @prev Main @next Do_czego __________ _ _ _ _ __________ _ _ _______/ ._______ _______._______ ._______ \_______ _ _ ._______ | /___.___\_____ | /___| /___. ___________. | /______|__. / | _______ | /___ | / |__\_________ | | /_________ |-------'----------'----------'----------'__________ | `----------------' - - ------- pRESENTs ------- - - `-------------tF!' @{b} Searcher@{ub} Wersja 1.1a, 21.6.1997 Copyright (c) 1997 LeMUr/blabla Instrukcja obsîugi, 5.09.97 @{b}Spis treôci: @{ub} 1. @{" Prawa autorskie i rozpowszechnianie " link Prawa} 2. @{" Do czego ten program sîuûy? " link Do_czego} 3. @{" Opis programu " link Opis} 4. @{" Wymagania, biblioteki, dane techniczne " link Wymagania} 5. @{" Komunikaty bîëdów " link Byki} 6. @{" Co w przyszîoôci? " link Future} 7. @{" Historia programu " link History} 8. @{" Co to jest BlaBla? " link BlaBla} 9. @{" Informacje od Autora " link Rest} @endnode @node Prawa "Prawa autorskie i rozpowszechnianie" @toc Main @prev Main @next Do_czego Ten program podlega @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT.pl/main 178}. Ten program jest ShareWare, jak zostaîo to okreôlone w punkcie @{"4s" link AFD-COPYRIGHT.pl/main 110}. Opîata rejestracyjna to równowartoôê $2 (na dzieï dzisiejszy jest to 6 PLN). Naleûy przesîaê te pieniâdze do mnie wraz z dyskietkâ i kopertâ zwrotnâ. Na dyskietce nagram peînâ wersjë Searchera zarejestrowanâ na konkretnâ osobë, o konkretnym numerze kopii. Wersjë DEMO moûna swobodnie rozpowszechniaê, nie pobierajâc przy tym ûadnych dodatkowch opîat (poza standardowymi opîatami za rozpowszechnianie oprogramowania PD). Jeôli szukasz wiëcej szczegóîów, proszë przeczytaê @{"AFD-COPYRIGHT" link AFD-COPYRIGHT.pl/main 1} (wersjë 1 lub nowszâ). @{" Prawa autorskie " link AFD-COPYRIGHT.pl/main 30} @{" Dystrybucja " link AFD-COPYRIGHT.pl/main 44} @{" Oôwiadczenie " link AFD-COPYRIGHT.pl/main 63} @{" Opîaty " link AFD-COPYRIGHT.pl/main 80} @endnode @node Do_czego "Do czego ten program sîuûy?" @toc Main @prev Main @next Opis Jeôli ktoô miaî kiedyô problem ze znalezieniem powiedzmy pliku o danej nazwie na twardym dysku, w gâszczu jego katalogów to potrzebny mu jest Searcher. Program ten wîaônie to robi - szuka plików odpowiadâcych podanemu wzorcowi. Nic szczególnego (jest takich programów trochë), ale Searcher ma cechy, których nie widziaîem nigdzie indziej. Potrafi znaleúê pliki na podstawie ich komentarza oraz pozwala na zmianë nazwy i/lub komentarza juû znalezionych plików. Dodatkowo moûna nagraê listë plików jako zbiór tekstowy, skopiowaê lub skasowaê któryô ze znalezionych plików. @endnode @node Opis "Opis programu" @toc Main @prev Do_czego @next Byki @{"Do czego ten program sîuûy" link Do_czego} juû napisaîem, czas na peîniejszy opis. @{" Wyszukiwanie plików " link mainwnd} @{" Konfiguracja " link configwnd} @{" Lista plików " link foundwnd} @{" Zmiany dotyczâce plików " link changewnd} Wszystkie podkreôlone literki w gadgetach oznaczajâ, ûe naciôniëcie danego klawisza spowoduje to samo co wybranie gadgetu myszkâ. Klawisze ESC oraz Q zwykle powodujâ zamkniëcie aktywnego okna BEZ zatwierdzania zmian (w oknach Config lub w Change). Zamkniëcie okna gîównego powoduje wyjôcie z programu (BEZ potwierdzenia). Klawisz Enter powoduje zaakceptowanie zmian lub rozpoczëcie poszukiwaï w wypadku gîównego okna. @{"Peîny opis klawiszy" link keys} znajduje sië w innym rozdziale. "Wrzucajâc" (klikajâc raz myszkâ na ikonie i trzymajâc lewy jej przycisk przeciâgajâc ikonkë na okienko) ikony do okna moûna automatycznie ustawiê katalog przeszukiwaê i w wypadku pliku - jego nazwë jako klucz w szukaniu wg. nazwy. Podobnie jest w trybie ikonifikacji - przeciâgajâc inne ikony na ikonkë uôpionego Searchera spowodujemy jego "obudzenie" :) a odpowiednie pola zostanâ wypeîniione jak poprzednio. Pomimo iû nie ma do tego gadgetu @{fg fill}proces przeszukiwania moûna przerwaê!@{fg text} Wiele osób zwracaîo na to uwagë, ale jest to od samego poczâtku moûliwe - wystarczy przytrzymaê prawy przycisk myszki przy aktywnym oknie "progress" @endnode @node keys "Opis klawiatury" MainWnd: ESC - Quit Enter - Find ? - Get dir a, A - bit A b, B - Search by c, C - Comment d, D - bit D e, E - bit E f, F - Find h, H - bit H g, G - Config i, I - Iconify l, L - List n, N - Name o, O - About p, P - bit P q, Q - Quit r, R - bit R s, S - bit S t, T - Path w, W - bit W z, Z - Size FoundWnd: ESC - Quit Enter - Change Curs Up - listview up Curs Down - listview down c, C - Change f, F - listview up/down o, O - Save one q, Q - Quit s, S - Save list ChangeWnd: ESC - Quit Enter - Okee a, A - bit A c, C - Cancel d, D - bit D e, E - bit E h, H - bit H m, M - Comment n, N - Name o, O - Okee p, P - bit P q, Q - Quit r, R - bit R s, S - bit S w, W - bit W l, L - Delete y, Y - Copy to ConfigWnd: ESC - Cancel Enter - OK r, R - Recursive p, P - Progress h, H - Type (files/dirs/all) o, O - OK c, C - Cancel f, F - LFormat ProgressWnd: RMB - przerwanie szukania @endnode @node mainwnd "Wyszukiwanie plików" @toc Opis @prev Opis @next configwnd Searcher umoûliwia szukanie plików/katalogów wedîug 4 kryteriów, które ustawia sië gadgetem-krëcioîkiem (cycle) pierwszym od góry z prawej strony okna ("Search by:"). Klawisz B na klawiaturze powoduje przewiniëcie krëcioîka do przodu, a Shift+B do tyîu o jednâ pozycjë. Proces szukania moûna przerwaê naciskajâc prawy przycisk myszy przy aktywnym oknie progress-indicatora (w wersji DEMO nie moûna wyîâczyê tego okna). Program sam przerwie poszukiwania informujâc o tym przy braku wolnej pamiëci na nowe znalezione dane lub w przypadku wystâpienia jakiegoô bîëdu. @{fg fill} 1. Nazwa pliku@{fg text} W tym trybie pod uwagë brane sâ nazwy plików i/lub katalogów. W polu (string-gadget) Name naleûy wpisaê maskë, do której majâ pasowaê pliki. Jest to standardowy "system maskowania" AmigaDOSu; uûycie "*" jest moûliwe i zastëpuje ono wszystkie znaki w dowolnej iloôci (odpowiednik #?). @{fg fill} 2. Komentarz do pliku@{fg text} (nieaktywne w wersji DEMO) Podobnie jak w przypadku nazwy moûliwe jest uûycie dowolnej maski okreôlajâcej tym razem komentarz do pliku. Ta bardzo przydatna cecha AmigaDOSu jest stosunkowo rzadko wykorzystywana, a szkoda. Searcher jako jedyny ze znanych mi programów tego typu potrafi odnaleúê pliki o podanym komentarzu. @{fg fill} 3. Rozmiar pliku@{fg text} Gadgetem krëcioîkiem "Size" ustawiamy czy dîugoôê znalezionych plików ma byê równa (==), mniejsza lub równa (<=), wiëksza lub równa (>=) czy teû róûna (<>) od podanej w nastëpnym gadgecie wielkoôci (w bajtach). @{fg fill} 4. Bity protekcji@{fg text} (nieaktywne w wersji DEMO) Podobnie jak z komentarzami tej opcji nie ma ûaden inny znany mi program do szukania plików. Pozwala na znalezienie wszystkich plików o danej masce bitów protekcji. Ustawienie np. na RWED powoduje szukanie wîaônie tak ustawionych bitów, nie pasuje do tego np. R-ED. @endnode @node configwnd "Konfiguracja" @toc Opis @prev mainwnd @next foundwnd W konfiguracji moûemy wîâczyê lub wyîâczyê szukanie rekurencyjne (jeôli program trafi na katalog przy wîâczonej rekurencji to sprawdzi jego zawartoôê wraz z odpowiednimi podkatalogami) oraz tzw. progress indicator, czyli okienko, w którym pokazywany jest aktualnie sprawdzany katalog. Oba przeîâczniki sâ nieaktywne w wersji DEMO i ustawione na "wîâczony". Moûna teû ustaliê czy do listy znalezionych w poszukiwaniach danych majâ byê doîâczane dane o plikach, katalogach czy teû zarówno plikach jak i katalogach. W polu "Format" ustalamy tzw. lformat zapisu danych w plikach z listâ znalezionych danych. Dostëpne znaki specjalne: @{fg fill} %p @{fg text}= sam katalog @{fg fill} %n @{fg text}= tylko nazwa @{fg fill} %f @{fg text}= peîna nazwa ze ôcieûkâ dostëpu @{fg fill} %c @{fg text}= komentarz @{fg fill} %s @{fg text}= rozmiar @{fg fill} %d @{fg text}= data + dzieï tygodnia + godzina ostanich zmian @{fg fill} %b @{fg text}= liczba bloków @{fg fill} %t @{fg text}= znak TABulacji @{fg fill} %r @{fg text}= znak Enter (nowa linia) plus inne znaki W wersji DEMO LFORMAT ustawiony jest na staîe na "%p%t; [%s] %c" Do peînej konfiguracji sîuûâ ToolTypes ikony programu. Oto peîna lista: - Poîoûenie okien: @{fg fill} MAINX @{fg text}\ okno @{fg fill} MAINY @{fg text}/ main @{fg fill} FOUNDX @{fg text}\ okno @{fg fill} FOUNDY @{fg text}/ found @{fg fill} CHANGEX @{fg text}\ okno @{fg fill} CHANGEY @{fg text}/ change @{fg fill} CONFIGX @{fg text}\ okno @{fg fill} CONFIGY @{fg text}/ config @{fg fill} PROGRESSX @{fg text}\ okno @{fg fill} PROGRESSY @{fg text}/ progress - Przeîâczniki: @{fg fill} ICONIFY @{fg text}- ikonifikacja przy starcie @{fg fill} PROGIND @{fg text}- progress indicator @{fg fill} RECUR @{fg text}- rekursja przy szukaniu @{fg fill} SHOW @{fg text}- pokazuj znalezione: 0 = pliki 1 = katalogi 2 = wszystko @{fg fill} FIND_BY @{fg text}- szukaj wedîug: 0 = nazwy 1 = rozmiaru 2 = komentarza 3 = bitów protekcji @{fg fill} PUBSCREEN @{fg text}- nazwa ekranu publicznego @{fg fill} BUFSIZE @{fg text}- wielkoôê bufora dla kopiowania plików @{fg fill} LFORMAT @{fg text}- format zapisu listy @{fg fill} REQTOOLS @{fg text}- do requesterów zostanie uûyta biblioteka reqtools (powinna byê na dysku). W przypadku jej braku (lub wyîâczonej opcje) bëðzie to systemowy ASL. - Ôcieûki: @{fg fill} START_PATH @{fg text}- ôcieûka startowa dla poszukiwaï @{fg fill} REPORT_DIR @{fg text}- ôcieûka dla raportów @{fg fill} DEST_DIR @{fg text}- ôcieûka dla zgrywania plików W wersji DEMO nie sâ obsîugiwane ToolTypes: LFORMAT, PROGIND, RECUR, SHOW, FIND_BY, BUFSIZE @endnode @node foundwnd "Lista znalezionych plików" @toc Opis @prev configwnd @next changewnd Po znalezieniu plików/katalogów pasujâcych do podanego kryterium poszukiwaï moûemy obejrzeê listë i ewentualnie zgraê jâ na dysk do pliku tekstowego zgodnie z ustawionym LFormatem. Zgraê moûemy caîâ listë (Save list) lub tylko aktualnie zaznaczonâ (i wyôwietlanâ w oknie) pozycjë (Save one). Klikajâc na gadgecie Change przechodzimy do @{"okna zmian" link changewnd} parametrów pliku. Po zamkniëciu okna z listâ moûliwy jest powrót do niego poprzez gadget "List" w oknie gîównym. Lista bëdzie w pamiëci do momentu wyjôcia z programu lub rozpoczëcia kolejnych poszukiwaï. @endnode @node changewnd "Zmiany dotyczâce plików" @toc Opis @prev foundwnd @next Byki W oknie tym moûemy zmieniê nazwë pliku/katalogu, jego komentarz i bity protekcji. W peînej wersji moûna takûe skopiowaê plik do wybranego katalogu lub go skasowaê (kasowaê moûna takûe katalogi o ile sâ puste). Zatwierdzenie zmian nazwy, komentarza i bitów protekcji nastëpuje przez wybranie Okee lub naciôniëcie Entera w oknie. ESC, Cancel lub zamkniëcie okna powoduje rezygnacjë. Zmiany zostajâ takûe odnowtowane w liôcie znalezionych plików/katalogów. Jeôli skasujemy (Delete, tylko w peînej wersji) danâ pozycjë z tej listy i bëdzie to ostatnia pozycja nastâpi powrót do gîównego okna. @endnode @node Wymagania "Wymagania, biblioteki, dane techniczne" @toc Main @prev Opis @next Byki @{fg fill} Wymagania:@{fg text} - Amiga z systemem co najmniej 2.0 (testowany tylko na 3.0 i 3.1) - biblioteka asl.library w wersji co najmniej 37 (lub reqtools.library v38 na ûyczenie uûytkownika) - "trochë" wolnej pamiëci na potrzebne dane (przydzielana dynamicznie, a iloôê zaleûna jest od iloôci plików odpowiadajâcych wzorcowi) @{fg fill} Dane techniczne:@{fg text} - program jest tzw. font-sensitive (dostosowuje sië do uûytej na ekranie czcionki) - program jest teû îatwy i przyjemny w obsîudze ;) - obsîuga z klawiatury i przy pomocy myszki - i oczywiôcie nie zajmuje wiele... - ...a co najwaûniejsze jest zgodny z mottem: @{i}"User & system friendly"@{ui} - ikonifikacja - jeôli dostëpna jest ikonka @{b}"ENV:SYS/def_blabla.info"@{ub} to zostanie ona uûyta, tak jak to jest w wypadku innych programów BlaBla Program korzysta z biblioteki @{b}reqtools.library@{ub} (c) 1992-1994 N.François, 1995 M.Holmgren Interface GUI zostaî stworzony przy uûyciu programu @{b}GadToolsBox v2.0b@{ub} (c) 1991-93 Jaba Development @endnode @node Byki "Komunikaty pîentuf" @toc Main @prev Opis @next History Program informuje o niemoûnoôci znalezienia czegokolwiek oraz o problemach z zajëciem pamiëci. Wiëcej bîëdów nie przewidujë, wiëc... nie ma wiëcej komunikatów :) @endnode @node Future "Co w przyszîoôci?" @toc Main @prev Byki @next History Jest jeszcze kilka rzeczy do zrobienia; oto kilka z nich: - lokalizacja - wyszukiwanie z datâ utworzenia zbioru jako kluczem - îâczenie kilku kluczy szukania - np. moduîy PT nie dîuûsze niû 60kB (Name mod.*; Size <= 60000) - byê moûe caîoôê bëdzie commodity? - on-line help - obsîuga MulitUsera - szukanie wg. wîaôcicieli i grup - port do komunikacji z innymi programami (np. Repackerem, nad którym obecnie pracujë) - byê moze takûe port ARexxa - szukanie w kilku katalogach - przeglâdanie listy juû podczas szukania @endnode @node History "Historia programu" @toc Main @prev Future @next BlaBla @{fg shine}wersja 0.79 @{fg text} 1.02.1997 o Pierwsza wersja publiczna. o Moûliwe sâ drobne bîëdy! @{fg shine}wersja 1.0 @{fg text} 15.03.1997 o Program staî sië shareware. o Dodane kilka ciekawych opcji, poprawione bîëdy, trochë optymalizacji o Standardowo rozpowszechniana tylko wersja DEMO @{fg shine}wersja 1.01 @{fg text} 11.04.1997 o Kilka poprawek (thx Thufor!) w programie i instrukcji @{fg shine}wersja 1.01a @{fg text} 23.04.1997 o Delikatna zmiana w GUI - wszystkie gadgety sâ teraz font-sensitive (v39) @{fg shine}wersja 1.01b @{fg text} 9.05.1997 o Kilka drobnych poprawek i caîkowite przekompilowanie kodu o Aktualizacja instrukcji @{fg shine}wersja 1.01b @{fg text} 9.05.1997 o Kilka drobnych poprawek i caîkowite przekompilowanie kodu o Standardowo moûna wybieraê ASL czy ReqTools o Aktualizacja instrukcji @endnode @node BlaBla "Co to jest BlaBla?" @toc Main @prev History @next Rest @{b}@{fg shine}BlaBla@{ub}@{fg text} jest to grupa zrzeszajâca programistów piszâcych programy wspóîpracujâce z systemem. Gwarantuje to poprawnâ pracë na wielu modelach Amig, oraz zapewnia zachowanie kompatybilnoôci "w górë". Pozwala to równieû na korzystanie z tak waûnej cechy, jakâ posiada @{i}@{fg fill}Amiga@{ui}@{fg text}, jak multitasking. Nasze programy majâ zazwyczaj status PublicDomain, FreeWare lub ShareWare, co pozwala na ich darmowe rozpowszechnianie. @{b}Grupa posiada wîasne ftp-site Internetowe@{ub}. Nasze najnowsze programy moûna równieû znaleúê w wydawanym przez nas pakiecie polskich programów uûytkowych @{b}PolWare@{ub}. Zapraszamy równieû do lektury redagowanego przez nas magazynu dyskowego @{b}Izviestia@{ub}. Traktuje on gîównie o programowaniu i zawiera opisy wielu ciekawych programów. Zainteresowanych wspóîpracâ z naszâ grupâ, bâdú chëtnych do wymiany doôwiadczeï i uwag na temat programów, prosimy o kontakt z którymô z czîonków @{b}@{fg shine}BlaBla@{ub}@{fg text}. @{i}W skîad grupy wchodzâ (IX'97):@{ui} - blabla: @{fg fill}Kordian Adamczyk @{fg text}@{i}(Kordi) @{ui} @{fg fill}Grzegorz Kraszewski @{fg text}@{i}(Krashan) @{ui} @{fg fill}Krzysztof Habowski @{fg text}@{i}(Kysy) @{ui} @{fg fill}Îukasz Prokulski @{fg text}@{i}(LeMUr) @{ui} @{fg fill}Marcin Ochocki @{fg text}@{i}(ScoTT) @{ui} @{fg fill}Dariusz J. Garbowski @{fg text}@{i}(Thufor) @{ui} @{fg fill}Tomasz Korolczuk @{fg text}@{i}(Tomash) @{ui} - sub-blabla: @{fg fill}Piotr Hoppe @{fg text}@{i}(Bruner) @{ui} @{fg fill}Krzysztof Wolski @{fg text}@{i}(Futrzak) @{ui} @{fg fill}Tomasz Kaczanowski @{fg text}@{i}(Kaczuô) @{ui} @{fg fill}Karol Bryd @{fg text}@{i}(Karol) @{ui} @{fg fill}Grzegorz Chmiel @{fg text}@{i}(Melon) @{ui} @{fg fill}Krzysztof Doliïski @{fg text}@{i}(Mr.DoDo) @{ui} @{fg fill}Piotr Wyderski @{fg text}@{i}(X-Pert) @{ui} @{fg fill}Tomasz Bieliïski @{fg text}@{i}(Siumot) @{ui} @{fg fill}Marcin Juszkiewicz @{fg text}@{i}(Szczepan)@{ui} @{fg fill}Daniel Owsianski @{fg text}@{i}(Valar) @{ui} @{fg fill}Przemysîaw Jeû @{fg text}@{i}(Warhawk) @{ui} @endnode @node Rest "Pozostaîe informacje" @toc Main @prev BlaBla @next Greets Kontakt z autorem: @{fg shine} Îukasz "LeMUr" Prokulski@{fg text} Dziaduszyce 25/1 32-218 Sîaboszów woj. kieleckie Polska tel. +48 (0498) 833990 wew. 170 (mogë byê trudno dostëpny...) Nie mam niestety wîasnego e-mail'a (jeszcze chwilë...), ale Thufor/blabla zgodziî sië udostëpniê nam (blabla) swoje konto jeôli chodzi o bug-raporty (liczë na nie!). Oto adres w sieci: @{fg fill} thufor@zeus.polsl.gliwice.pl@{fg text} Zapraszam takûe na naszâ stronë WWW, na której znajdziecie kilka informacji o grupie i jej produktach: @{fg fill} http://www.gliwice.pl/~thufor@{fg text} Nowe programy z blabla dostëpne sâ takûe na dyskach PD z serii @{fg shine}PolWare@{fg text}. @{" Pozdrowionka i podziëkowanka " link Greets} @endnode @node Greets " Pozrowionka und podziëkowanka " @toc Rest @prev Rest @next Main Korzystajâc z okazji chciaîbym pozdrowiê (kolejnoôê losowa): - caîe blabla za "drogë do dzisiaj", a w szczególnoôci: -@{i} Tomash @{ui}- dziëki za to, ûe jesteô!!! -@{i} Kysy @{ui}- ÛYJ!, facet, ÛYJ! -@{i} ScoTT @{ui}- z KORnika chyba nieprëdko coô bëdzie... -@{i} Thufor @{ui}- moûe wpadniecie... -@{i} Warhawk @{ui}- ...do mnie s00n? -@{i} Reese @{ui}- koniec z "blibliotekarstwem"? -@{i} Kordi @{ui}- Moûesz sië wkrótce przydaê, chemiku :)) - caîâ resztë: -@{i} Beata @{ui}- dziëki za... niewaûne ;) -@{i} Magda @{ui}- za caîoksztaît i wspaniaîâ Przyjaúï -@{i} Magda @{ui}- za caîoksztaît i wspaniaîâ Przyjaúï -@{i} Bubba @{ui}- za wakacje i wszystko inne -@{i} CED @{ui}- to soon maturka, co? hîehîe... -@{i} Spirol @{ui}- dawaj moje chunky-2-planar! Podziëkowanka specialnie dla: -@{i} Îatka @{ui}- (moja psa) za odrywanie mnie od tej chorej momentami pracy -@{i} The Doors @{ui}- za -@{i} Pearl Jam @{ui} -@{i} Illusion @{ui}- support -@{i} The Prodigy @{ui} -@{i} Kobong @{ui}- w ukochanâ -@{i} Kazik @{ui} -@{i} Pink Floyd @{ui}- muzë -@{i} moje Hi-Fi @{ui}- za jej dostarczanie @endnode