@database Instruction.guide @node main "Manual - main menu" @{b}@{fg shine} __________ _ _ _ _ __________ _ _ _______/ ._______ _______._______ ._______ \_______ _ _ ._______ | /___.___\_____ | /___| /___. ___________. | /______|__. / | _______ | /___ | / |__\_________ | | /_________ |-------'----------'----------'----------'__________ | `----------------' - - ------- pRESENTs ------- - - `-------------tF!'@{ub}@{fg text} @{b} DailyUP @{ub} Version 1.18 Date 98-Feb-04 Copyright (c) 1997 Karol Bryd/BLABLA Instrukcja obsîugi User's Manual @{" Prawa autorskie, dystrybucja. " link Prawa} @{" Copyrights and distribution. " link Copyrights} @{" Do czego ten program sîuûy? " link Do_czego} @{" Introduction. " link Introduction} @{" Opis programu. " link Opis} @{" Instructions. " link Instructions} @{" Wymagania. " link Wymagania} @{" System requirements. " link Requirements} @{" Komunikaty pîentuf. " link Byki} @{" Error messages. " link Errors} @{" Instalacja programu. " link Instalacja} @{" Instalation. " link Instalation} @{" Co w przyszîoôci? " link CoDalej} @{" What in future? " link Future} @{" Historia programu. " link Historia} @{" History. " link History} @{" Co to jest BlaBla? " link BlaBlaPL} @{" BlaBla? What's that? " link BlaBla} @{" Pozostaîe informacje. " link Reszta} @{" Other informations. " link Rest} @endnode @node Prawa "Prawa autorskie i rozpowszechnianie" @{b}Prawa autorskie@{ub} Ten program podlega @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT.pl/main 178}. Ten program jest MailWare, jak zostaîo to okreôlone w punkcie @{"4b" link AFD-COPYRIGHT.pl/main 92}. 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?" @{b}Zastosowanie@{ub} Dawno, dawno temu (dokîadnie w marcu 97 roku) nagle napadîa mnie myôl: ile ja poôwiëcam czasu Amidze !??! Niestety do tej pory chyba nikt o tym nie myôlaî bo nie znalazîem ûadnego porzâdnego programu, który odpowiedziaîby mi na to pytanie. Jednak ktoô napisaî te wszystkie kompilatory, asemblery wiëc w napisaniu tego programu przeszkodâ byî tylko czas. Po pewnym czasie siadîem i program napisaîem :) potem przez wiele miesiëcy testowaîem go, dodawaîem nowe opcje, i ogólnie rozszerzaîem jego moûliwoôci. W obecnej chwili program jest dosyê rozbudowany i jak myôlë na powyûsze pytanie potrafi odpowiedzieê juû doôê dobrze i dokîadnie. Jak kaûdy program tak i ten jeszcze *ma* bîëdy, problem w tym, ûe ja nie wiem gdzie one sâ :( Mimo, ûe program byî testowany, a takûe sprawdzaî sië w codziennym dziaîaniu (u mnie dziaîa *caîy* czas) to gdzieô tam w zakamarkach, jakieô bug'i sâ na pewno, dlatego teû jeûeli znajdziesz jakiô bîâd to koniecznie mnie powiadom (oczywiôcie opisz kiedy sië ten bîâd objawiî i w jakich okolicznoôciach). @endnode @node Opis "Opis programu" @{b}Opis programu@{ub} Uûywanie tego programu moim zdaniem jest banalne, sama instalacja sprowadza sië do przekopiowania pliku gîównego programu do jakiegoô katalogu oraz uruchomienie go albo z sekwencji startowej (przez run >nil: dailyup >nil:) albo lub z WBStartup. Gdy ta "instalacja" zostanie ukoïczona pomyôlnie to po kaûdym zabootowaniu program sië uruchomi i bëdzie zapisywaî co 60 sek. (wartoôê domyôlna - moûna zmieniê) pewne dane do pliku s:dailyup.prefs. Ponadto przy pierwszym boocie nastepnego dnia program dopisze pewne informacje do pliku s:dailyup.dailyprefs (plik ten skîadujë dane z poszczególnych dni) oraz gdy tego chcemy wyôwietli informacjë ile czasu spëdziliômy przy komputerze dnia poprzedniego oraz obliczy ôredniâ arytmetycznâ z caîego okresu dziaîania programu i z ostatniego miesiâca . Zawsze gdy program dziaîa mamy do dyspozycji dwa hot-keye, które sâ redefiniowalne. Pierwszy z nich to hot-key dziëki któremu moûemy wyjôê z programu, natomiast drugi hot-key umoûliwia nam otwarcie okna informacyjnego z informacjami nt. spëdzonego czasu w poszczególnych dniach. Przy uruchamianiu programu moûemy uûyê nastëpujâce opcje: CX_PRI - jest to priorytet "commodities", jeûeli sië nie znasz to lepiej nic tu nie zmieniaj. CX_POPKEY - tutaj wpisz jaka kombinacja klawiszy ma wywoîaê okno informacyjne. CX_QUITKEY - tutaj wpisz kombinacjë klawiszy usuwajâcych program z pamiëci. Hotkey'e moûna wygodniej definiowaê za pomocâ preferencji, wystarczy otworzyê okno preferencji, a potem za pomocâ gadûetu popup przy danym hotkey'u wywoîaê kolejne oknienko i tam uaktywniê opcjë "Scan". Od teraz wciôniëcie rzâdanej kombinacji klawiszy spowoduje zapamiëtanie jej i po zapisaniu konfiguracji stanie sië ona aktywnym hotkey'em. Po wciôniëciu hotkey'a "CX_POPKEY" ukaûe sië na ekranie gîówne okno programu z którego mamy moûliwoôê sterowaê caîym programem. W oknie wiëkszoôê miejsca zajmuje gadget ListView w którym znajdujâ sië zapisy z poszczególnych dni dziaîania programu. Kontrolë nad tym co ma sië znaleôê w tym oknie sprawujâ dwie pozycje z menu "Preferences": - Show this month only - spowoduje, ûe w oknie wylistowane zostanâ pozycje tylko z aktualnego miesiâca. - Show days with uptime only - spowoduje, ûe wylistowane zostanâ tyklo te dni w których komputer byî wîâczony choêby przez chwilë, dni z uptime równym 0 zostanâ pominiëte. Poniûej gaûetu Listview znajduje sië linia informacyjna, która zawiera informacje o tym przez ile czasu Twój komputer jest dzsiaj wîâczony, a takûe ôredniâ z ostatniego miesiâca i caîego okresu kiedy program dziaîaî. Obok znajdujâ sië jeszcze dwa gaûety: jeden zamyka okno (jednak nie powoduje wyjôcia z programu), natomiast drugi wyôwietla maîâ informacjë o programie. Oprócz tych dwóch gadgetów w górnych menusach znajduje sië kilka opcji. Save List As... - dziëki tej funkcji moûemy zapisaê listë do pliku, lista bëdzie normalnym plikiem tekstowym. Print List... - drukuje na drukarce listë - moûna wtedy jâ pokazaê np. mamusi, i udowodniê, ûe nie siedziaîeô w przeddzieï matury 12 godzin przed komputerem i dlatego nie zdaîeô... (opcja nie jest jeszcze przetestowana - nie mam drukarki...) Show Graphs - dziëki tej opcji bëdziesz mógî zobaczyê dane tekstowe, które widzisz w oknie w formie graficznej, która na pewno jest bardziej przyjazna dla oka... Pierwszy rodzaj ykresu pokazje po prostu przez jaki czas Twój komputer byî wîâczony danego dnia. Oprócz tego linia druga (biaîy kolor) pokazuje ôredniâ od poczâtku kaûdego tygodnia. Drugi rodzaj wykresów (Logins&Logouts) pokazuje kiedy wîâczyîeô komputer oraz kiedy go wyîâczyîeô. Myôlë, ûe nie ma tu o czym pisaê, wykresy sâ samo wyjaôniajâce sië... Natomiast trzeci ukazuje to sao co wykres 1. ale w innej formie, bowiem zamiast krzywej sâ sîupki, ponoê jest to bardziej odpowiedni typ wykresu dla takiego typu danych. Biaîa linia to podobnie jak w wykresie 1. jest liniâ ôredniej. Preferences - tutaj moûna zmieniaê dwa parametry dotyczâce pracy programu: Preferences - otwiera okno z preferencjami, moûna tam zmieniê okres po jakim program bëdzie zapisywaî stan licznika do pliku, a takûe wîâczaê i wyîâczaê pojawianie sië komunikatów z informacjami o poprzednim dniu. Ponadto jak juû wspomniaîem tutaj moûna redefiniowaê hotkey'e. Show days with uptime only oraz Show this month only juû opisaîem wczeôniej. No i to by byîo tyle na temat opcji programu. @endnode @node Wymagania "Wymagania, biblioteki, dane techniczne" @{b}Wymagania@{ub} Program WYMAGA zegara czasu rzeczywistego w komputerze, co prawda gdy go nie ma to nigdzie tego nie wypisujë ale wynikiem dziaîania bëdâ bzdury. Moûna kaûdorazowo przy uruchomieniu komputera ustawiaê datë rëcznie ale wâtpie aby sië znalazî taki ômiaîek. Oprócz tego program ma wymagania sâ prawie minimalne: system 3.0+, zainstalowana biblioteka MUI, kilkadziesiât kilo pamiëci no i przydaîby sie twardy dysk, ale bez niego teû moûna. Program byî testowany na Amidze 1200 z procesorem 030/40MHz, 8MB fast, HD i systemem 3.0 i 3.1 tak wiëc gdy na Twojej konfiguracji program odmawia dziaîania to skontaktuj sie ze mnâ (adres gdzieô w tym pliku). @endnode @node Byki "Komunikaty pîentuf" @{b}Komunikaty bîëdów@{ub} Nie pamiëtam a nie chce mi sië juû sprawdzaê, mimo to sâ zrozumiaîe. @endnode @node Instalacja "Instalacja programu" @{b}Instalacja@{ub} Jak juû wczeôniej pisaîem instalacja programu sprowadza sië do przekopiowania gîównego pliku programu (tj. DailyUP) do dowolnego katalogu i uruchomienie go z sekwencji startowej (przez run >nil:) lub z WBStartup. Jeûeli nie masz zainstalowanych klas popxxx, to *musisz* je przekopiowaê z archiwum (mui/) do katalogu MUI:libs/mui. Bez tego program nie zadziaîa. @endnode @node CoDalej "Co w przyszîoôci?" @{b}Co w rzyszîoôci?@{ub} Na razie nic, chyba ûe dasz jakieô pomysîy, ja zamierzam w najbliûszym czasie poprawiê tylko kilka bîëdów, które sië ostaîy (wiem nawet gdzie !). Inne rzeczy bëdâ póúniej. @endnode @node Historia "Historia programu" @{b}Historia@{ub} wersja 1.0 97-Apr-20 o Dodane zapisywanie struktury Date, wyliczanie ôredniej 97-Apr-28 o Dodana moûliwoôê obejrzenia danych z konkretnego dnia wersja 1.1 97-May-02 o Dodane commodities, okno zamiast pliku tekstowego wersja 1.11 97-Jun-07 o poprawiona masa niedociâgniëê (big thanks dla LeMUra !), poprawione commodities, szybsze wyôwietlanie danych w oknie, buforowane operacje we/wy, zliczanie czasu nawet wtedy gdy otwarte jest okno i jeszcze kilka innych maîych usprawnieï o których nawet ja zapomniaîem wersja 1.11 97-Jun-27 o dodane obliczanie ôredniej tylko z ostatniego miesiâca, lekko zmodyfikowany GUI (dodany gadget typu Text oraz gadget About) wersja 1.11 97-Jul-13 o poprawiony bug objawiajâcy sië tym, ûe program zapisywaî ten sam dzieï do logu nawet kilka razy wersja 1.12 97-Jul-27 o zamiast triton.library jest muimaster.library, przepisana od nowa procedura do ôredniej - tearz trochë bardziej wiarygodna... wersja 1.13 o teraz korzystam z brokera MUI, a nie ze swojej roboty, w taki sposób jeden port w systemie mniej. wersja 1.15 97-Sep-02 o WYKRESY !!! wersja 1.16 97-Oct-13 o usuniëta blabla.library, reqtools.library - w zamian asl.library oraz intuition.library (powrót do úródeî !). Znowu poprawione wykresy, zachowanie przy nowym roku (bynajmniej nie przy stole ;)) wersja 1.17 97-Nov-11 o poprawiona pewna ilosc niedociagniec, poprawiona procedura pomocnicza przy tworzeniu wykresow, i tym samym wykresy sa teraz bardziej dokladne, prawdopodobienstwo rozwalidatowania dysku przy pracy z tym programem zmalalo prawie do zera. wersja 1.18 97-Feb-04 o poprawione naprawdë duûo rzeczy: zawieszanie sië przywychodzeniu z programu przez "Quit", wykresy Logins&Logout, opóúnienia w reagowaniu na hotkey'e i jeszcze sporo innych rzeczy. Dodane zostaîy: nowe okno preferencyjne, kolumny w gadgecie Listview, allokacja pamiëci za pomocâ LibAllocPooled(), wszystkie czasy sâ teraz wyôwietlane w godzinach z minutami a nie w postaci uîamków, nowy rodzaj wykresu... @endnode @node BlaBlaPL "Co to jest BlaBla?" @{b}Co to jest BlaBla?@{ub} @{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 konto Internetowe i BBS@{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â (I'97):@{ui} @{fg fill}Apacz/SubBlaBla@{fg text} @{i}(Michaî Kopacz)@{ui} @{fg fill}Kordi/DuckRed & BlaBla@{fg text} @{i}(Kordian Adamczyk)@{ui} @{fg fill}Kysy/AM & 2xBla@{fg text} @{i}(Krzysztof Habowski)@{ui} @{fg fill}LeMUr/bla²@{fg text} @{i}(Îukasz Prokulski)@{ui} @{fg fill}Karol/SubBlaBla@{fg text} @{i}(Karol Bryd)@{ui} @{fg fill}Scott/Inferno & BlaBla@{fg text} @{i}(Marcin Ochocki)@{ui} @{fg fill}Thufor/BlahBlah@{fg text} @{i}(Dariusz J.Garbowski)@{ui} @{fg fill}Tomash/Art-B & BBla@{fg text} @{i}(Tomasz Korolczuk)@{ui} @{fg fill}Warhawk/SubBlaBla@{fg text} @{i}(Przemysîaw Jeû)@{ui} @endnode @node Reszta "Pozostaîe informacje" @{b}Pozostaîe informacje@{ub} Podziekowania dla: Pawla Rutkowskiego za sprawdzenie angielskiej wersji tej instrukcji. BLABLA - za wszystko ;) Jeûeli korzystasz z programu czësto (czyt. caîy czas - gdyû idea programu wyklucza chwilowe korzystanie) to musisz mi przysîaê  list z kilkoma dobrymi sîowami. To Twój obowiâzek moralny ! Mój adres: Karol Bryd Piaski Brzustowskie 194a 27-520 Êmielów PS szukam îadnych ikonek zarówno MWB jak i NewIcons do tego programu, jeôli potrafisz je îadnie zrobiê to daj znaê ! email: kbryd@kki.net.pl odwiedú nasze strony WWW: www.gliwice.pl/~thufor @endnode @node Copyrights "Copyrights and distribution" @{b}Copyrights@{ub} This program is subordinated to @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT/main 167}. It is MailWare, which is specifird in item @{" 4b " link AFD-COPYRIGHT/main 86}. For more informations you should read @{"AFD-COPYRIGHT" link AFD-COPYRIGHT/main 1} (version 1 or newer). @{" Copyright " link AFD-COPYRIGHT/main 28} @{" Distribution " link AFD-COPYRIGHT/main 42} @{" Disclaimer " link AFD-COPYRIGHT/main 60} @{" Return Service " link AFD-COPYRIGHT/main 76} @endnode @node Introduction "Introduction" @{b}Introduction@{ub} First thing that I have to say is that I don't know English ! Please forgive bad spelling, grammar mistakes and so on. I hope that this guide will help you and will be useful and all my hard work with dictionaries won't be wasted... I can bet that you wanted to know how many time you are spending working on your Amiga computer. What ?? No ? Hmmm...However I did, but I couldn't find any program which would do this kind of stuff. So on one Saturday morning I sat down and begun to writing this program. After a few hours a first version was ready. Well, a first version was very primitive and did nothing except counting time - no averages and other fancy stuff. Only few weeks later I rewrite almost all code and DailyUP 1.0 was born. Hard to say but it also was nothing special but at least it has small GUI and it was little more economic (2 instead of 3 .prefs files). Many people didn't like this program in that version only for reason that DailyUP was using triton.library but at least I've liked this program very much. Next version which came out wasn't using triton.library but instead it muimaster.library which, I hope, is more liked. A few days later I began again improving this programm, first thing which I wrote were graphs. I think it is cool option and it's worth time it took to wrote. This program is MailWare so you should (e)mail me and say how this program is working. @endnode @node Instructions "Instructions" @{b}Instructions@{ub} The installation itself is described in a seperate node and here I'll try to describe how to use this program. When you have sucessfully started the program then you can use two hotkeys, one of them is to invoking a program's window and second is to quitting. CX_POPKEY - default is "lctrl lalt s", when you press this combination of keys then a window will appear on a screen. That window have two gadgets. One is labeled "Close" and second "About". I think that names tells you everything. Beside of those two gadgets there are also a few menu items which are described later in this file. It's important to distinguish a "Close" button and a "Quit" menuitem, first one only close the window and do not quits the program but second exits from the program immediately ! CX_QUITKEY - default is "lctrl lalt q". When you press this hotkey program will simply quit. If you want to redefine these hotkeys then you can do it via ToolTypes pr via Preferences window. In pull-up menus there are also other few options: Preferences: Here you can change these two parameters: * Delay - this changes period of time after which program is saving actual time counter to disk. * Daily reports - Turns on and off requester which is appearing on the new day. * and as I said before you can change here hot keys. Show days with uptime only - causes that there will be listed entries only from days with any uptime. Show this month only - lists in window days only from actual month. Save List As... - simply save a list to a file. Print List - print a list on a printer (this option isn't already enough tested - I don't have a printer...) And of course the Graph option which will present all "text" data in graphic form. It isn't hard to understand how it works so I won't write about it. (small note: white curve in the graphs is the average curve, and the black one represents your daily up time) In Graph windows there are only two gadgets: one selects a month, and second selects kind of graph. There are three kinds of graphs. * First - DailyUps - draws your average and daily up time. * Scond draw is representing your login and logout times. * Third is similiar to the first graph, but instead of lines rectanlges are used. @endnode @node Requirements "System requirements" @{b}Requirements@{ub} This program require following resources: 1. Amiga ;) 2. KickStart 3.0+ 3. installed MUI package @endnode @node Errors "Error messages" @{b}Error Messages@{ub} Sorry but I don't remember error messages ;) but they aren't hard to understand so you shouldn't have any problems with it. Anyway this program is so well coded that error-messages would tell you everything ;) (joking....;))) @endnode @node Instalation "Instalation" @{b}Instalation@{ub} To run this program correctly you must do these things: 1. unpack the archive with program (it seems that you've already done it) 2. copy DailyUP file into any directory you like 3. copy files from DailyUp/mui/ to mui:libs/mui/ 3. in the startup-sequence after a line which executes the user-startup script put a following line: run >nil: dailyup >nil: This is an entire instalation procedure, very complicated, isn't it ? @endnode @node Future "What's in future" @{b}What's in future?@{ub} It's depends on you ! For now I don't have too much time to spare on programming (you know, school and so on...), but if I'll get to know that this program is popular and you like it then of course I'll improve it. If you have any ideas then simply let me know. For sure I'll do something with your ideas. @endnode @node History "Program History" @{b}History@{ub} History of this program is so complicated that even I don't know it. Of course it's not true ;) I know it's history but I am too lazy to include it here. If you are very intrigue with it then look in Polish version of this doc (if you know Polish language, if not, learn it ! It might be useful). @endnode @node BlaBla "BlaBla - what's that?" @{b}What is BlaBla?@{ub} @{b}@{fg shine}BlaBla@{ub}@{fg text} is a Polish biggest system programmers group. We make the system friendly programms. We guarantee that our programs will run on almost every machine (@{fg fill}Amiga@{fg text} of course), including future ones. All our programs are running in multitasking, and all of them are PD, Freeware, or Shareware. Our organisation has a few members (we "absorb" only good programmers), own e-mail address and own @{b}BBS@{ub}. Our newest productions you can find in our PD library called "@{b}Polware@{ub}". Our texts, articles you can also find in our disk-mag "@{b}Izviestia@{ub}" (sorry, in Polish!). @{i}Blabla memberlist (I'97):@{ui} @{fg fill}Apacz/SubBlaBla@{fg text} @{i}(Michaî Kopacz)@{ui} @{fg fill}Kordi/DuckRed & BlaBla@{fg text} @{i}(Kordian Adamczyk)@{ui} @{fg fill}Kysy/AM & 2xBla@{fg text} @{i}(Krzysztof Habowski)@{ui} @{fg fill}LeMUr/bla²@{fg text} @{i}(Îukasz Prokulski)@{ui} @{fg fill}Karol/SubBlaBla@{fg text} @{i}(Karol Bryd)@{ui} @{fg fill}Scott/Inferno & BlaBla@{fg text} @{i}(Marcin Ochocki)@{ui} @{fg fill}Thufor/BlahBlah@{fg text} @{i}(Dariusz J.Garbowski)@{ui} @{fg fill}Tomash/Art-B & BBla@{fg text} @{i}(Tomasz Korolczuk)@{ui} @{fg fill}Warhawk/SubBlaBla@{fg text} @{i}(Przemysîaw Jeû)@{ui} @{b}@{fg shine}BlaBla@{ub}@{fg text} group is well-known in Poland, and programs signed with "Blabla" are for sure very good. We made many productions, we help many young programmers, we write articles to Polish edition of @{b}Amiga Magazine@{ub}, @{i}we try to do all, for our beloved computer - Amiga!@{ui} @endnode @endnode @node Rest "Other information" @{b}Other Information@{ub} Big thanks goes to: Pawel Rutkowski - for checking up the manual for this program. But if you find any mistake then it's my fault ! If you like this program then you must write to me and say a few good words about my programming skills ! It's your moral obligation ! snail-mail: Karol Bryd Piaski Brzustowskie 194A 27-520 Cmielow POLAND email: kbryd@kki.net.pl visit our WWW pages at: www.gliwice.pl/~thufor IMPORTANT !!! I'm looking for nice icons (both Magic WB and NewIcons) for this program. If you are enough good to draw them please contact with me. @endnode