This post comes from the first version of this blog.
Please send me an email if anything needs an update. Thanks!
Od dłuższego czasu odkrywam możliwości środowiska programistycznego Eclipse [głównie przy użyciu modułów CDT i PDT]. Jestem naprawdę zadowolony z tego programu, poza tym cieszę się, że społeczność wolnego oprogramowania mogła “dorobić się” tak porządnego narzędzia, przez co “kupowanie” wszelkiego rodzaju “zamkniętych” rozwiązań w sklepach typu Rapidshare tudzież serwisach zorientowanych wokół P2P powoli przestaje mieć sens. ;] Jedynym minusem takiej “przesiadki” jest jednak to, że ponownie trzeba nauczyć się “gdzie co jest” - skróty klawiaturowe, położenie różnych ustawień, przycisków - jednym słowem poznać nowe narzędzie co najmniej tak, jak znało się poprzednie. I chociaż Eclipse jest generalnie bardzo intuicyjne i w niewielu przypadkach musimy się czegokolwiek domyślać lub szukać, to jednak czasem bez pomocy ani rusz. Tak też było z opisanym w niniejszym artykule oknem dokumentacji.
Wstęp. Mam nadzieję, że nie wprowadzę jakiejkolwiek dezinformacji przez tytuł ani użyte nazewnictwo - szukając informacji które mogłyby nieco rozszerzyć tematykę wpisu nie potrafiłem znaleźć zbyt wielu pomocnych materiałów, głównie ze względu na fakt, że nazwy “code assist”, “phpdoc assist”, “documentation tooltip” i wszelkie ich złożenia były używane wymiennie. Które z okien mam więc na myśli? Proszę Państwa, powitajmy obrazek [życzenie Czytelnika jest dla mnie rozkazem ;]]:
Na powyższym obrazku widzimy fragment dokumentacji atrybutu klasy oraz okienko z podpowiedzią, która zostanie wyświetlona po najechaniu na każde wystąpienie tego atrybutu. Jak widzimy, wszystkie informacje ładnie wyświetliły się w podpowiedzi, przez co nie musimy przewijać setek linii kodu aby przypomnieć sobie do czego służyła dana zmienna. Na czym polega więc problem?
Problem i rozwiązanie.
Jako bystry czytelnik na pewno wiesz już o co mi chodzi. Ale żeby było bardziej interaktywnie proponuję scenkę rodzajową pod tytułem "co by było gdyby". Występują:- [C] - Pan Czytelnik,
- [P] - Pan Programista,
- [W] - Widownia.
- [C] - Panie Programisto?
- [P] - Taak, Panie Czytelniku?
- [C] - A co będzie jak tych informacji będzie... ehm... "trochę" więcej...?
- [P] - Ekhm... "ile" więcej?
- [C] - Na przykład... "tyle":
- [W] [Oklaski dla kolejnego obrazka]
- [P] - No to będzie mały problem... A mam tu małe rozwiązanko!
Co prawda nie da się zwiększyć rozmiaru tego okienka, ale można sprawić, żeby stało się “rozciągalne”, tj. podobnie jak w przypadku okna z podpowiedziami do kodu można “złapać” myszką prawy dolny róg i dostosować do własnych wymagań. Aby tak się stało, należy użyć klawisza [F2]. I koniec. Prawda, że proste? ;]