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.
Akt I i ostatni:
  • [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!
Rozwiązanie.

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? ;]

Podsumowanie.

Podobno jest także możliwa zmiana tego rozmiaru na stałe, ale przeszukałem wszelkie opcje i pliki konfiguracyjne - niestety bezskutecznie. Jeśli uda mi się to zrobić, na pewno zaktualizuję wpis o niezbędne informacje.