2009-12-11 11 views
6

Nigdy nie widziałem sensu instalowania ri i rdoc dla klejnotów, a mój plik .gemrc ma zestaw --no-ri i --no-rdoc. Ponieważ każdy klej zawiera informacje ri i rdoc, po prostu zastanawiałem się, czy czegoś brakuje. Czy jest jakaś zaleta instalowania ri i rdoc dla klejnotów?Czy brakuje mi czegoś, nie instalując ri i rdoc na klejnoty?

Dzięki

Chris

Podsumowanie

Jeśli nie zainstalować Ri i rdoc, nie tracą nic z wielką wartość. Pomyślałem, że może został użyty w niektórych IDE (jestem użytkownikiem Emacsa), ale tak się nie dzieje.

Odpowiedz

11

Punkt instalacji dokumentacji ri polega na tym, że można użyć polecenia "ri", aby uzyskać dostęp do dokumentacji metodą metodą. Dla przykładu spróbuj: "ri String # reverse". Wyjdź, naciskając "q".

Aby wypróbować dokumentację RDoc, uruchom "serwer gem", a następnie połącz się z localhost: 8808 w przeglądarce. Uważam, że jest przydatny - możesz nawet kliknąć nazwę metody, aby zobaczyć kod źródłowy. Oczywiście możesz po prostu przejść do folderu z klejnotami i otworzyć pliki HTML w folderze doc.

Alternatywnym sposobem uzyskania dostępu do RDoc jest komenda gemdoc. Zobacz http://www.stephencelis.com/2008/06/12/bashfully-yours-gem-shortcuts.html. To bardzo przydatne, IMHO.

W każdym razie możesz być leniwy i poczekać, aż potrzebujesz dokumentacji RDoc, a następnie wygenerować ją za pomocą "gem rdoc".

+0

Dzięki za wzmiankę o serwerze gem –

2

Zainstaluj, jeśli chcesz mieć dostępną lokalnie dokumentację klejnotu.

+0

Tak naprawdę tak naprawdę niczego nie brakuje. –

3

Osobiście instaluję moje klejnoty bez rdoc i ri, ponieważ zazwyczaj można znaleźć całą potrzebną dokumentację w Internecie (np. Www.rdoc.info), więc nie trzeba inwestować ciężko miejsca na dysku i czas generacji odbywa

0

Ten artykuł daje wielki, dlaczego i jak z użyciem ri:

http://jstorimer.com/ri.html

najlepszy punkt na tej liście jest # 1: ri rozumie Ruby. Na przykład:

$ ri ActiveRecord::Base#save 
(from gem activerecord-3.2.8) 
Implementation from ActiveRecord::Persistence 

[...] 

(from gem activerecord-3.2.8) 
Implementation from ActiveRecord::Validations 

[...] 

Wskazówka sposób jest znaleźć nawet jeśli nie bezpośrednio na ActiveRecord :: samej bazy.

Powiązane problemy