La sintassi di ricerca può contenere uno qualsiasi dei seguenti elementi:
Parole – Per trovare manuali che contengano una o più parole (termini), digitare tali parole nel campo Ricerca inserendo uno o più spazi tra una parola e l'altra. Le ricerche di parole multiple restituiscono un elenco di manuali in cui sono comprese tali parole, in qualunque punto e ordine appaiano nei manuali. È possibile anche effettuare la ricerca in base al numero parte.
I caratteri diversi da lettere o numeri vengono utilizzati nel modo seguente:
I simboli pipe (|), maggiore di (>), minore di (<), il segno meno (-), i caratteri chiocciola (@), barra (/) e barra rovesciata (\) vengono utilizzati come elementi separatori di parole. Ad esempio, la ricerca dell'espressione Sun-Fire produrrà gli stessi risultati della ricerca delle parole "Sun" e "Fire".
Il segno più (+), i caratteri cancelletto (#), dollaro ($), percentuale (%) ed e commerciale (&) vengono utilizzati come elementi di inizio parola. Ad esempio, l'espressione #includi indica una singola parola, mentre l'espressione #definisci#includi viene considerata come composta dalle parole "#definisci" e "#includi".
Frasi – Per trovare manuali che contengano una certa frase, occorre racchiudere tale frase tra virgolette ( ") nel campo Ricerca. Le richieste di ricerca di frasi restituiscono un elenco di manuali in cui le parole sono visualizzate una accanto all'altra nell'ordine specificato.
Nella stessa richiesta di ricerca è possibile combinare frasi multiple: per esempio, quando si ricerca la frase "sistema solaris" CD, vengono elencati i manuali che contengono la frase completa “sistema solaris” e la parola “CD”.
Operatore jolly (*) – Per trovare manuali che contengano varianti di una parola, occorre includere un asterisco (*) alla fine della parola, o della parola all'interno di una frase, che si desidera ricercare nel campo Ricerca.
Al momento non è possibile utilizzare l'operatore jolly all'inizio o al centro di parole o stringhe.
Quando si digita, per esempio, CD*, vengono elencati i manuali che contengono le parole CD, CDs, CD-ROM, CD-ROMs e CD_ROM_FOLDER.
Il sito Web docs.sun.com è concepito per ricercare i manuali, non le pagine che contengono; quando si effettua una ricerca globale, o si utilizza il menu Ricerca in, tutti i manuali del sito vengono considerati allo stesso modo, indipendentemente dal fatto che siano basati su XML, che siano documenti HTML o manuali solo PDF.
Quando si effettua la ricerca in tutti i manuali, o si utilizza il menu Ricerca in per la ricerca nell'ambito di un dato argomento, prodotto o collezione, il numero di manuali contenenti la stringa ricercata viene visualizzato nella parte superiore della pagina relativa ai risultati della ricerca. In una pagina sono visualizzabili solo 50 manuali: se la stringa è contenuta in un numero di manuali superiore a 50, l'elenco dei risultati continua alla pagina successiva. La barra di navigazione collocata in posizione centrale nella parte superiore e inferiore della pagina indica il numero totale di pagine disponibili, mentre l'indicatore punta alla pagina attuale. È possibile visualizzare le altre pagine facendo clic sul numero di pagina.
Un elevato numero di risultati potrebbe indicare la necessità di restringere la ricerca modificando il testo di ricerca, oppure utilizzando il menu Ricerca in per ridurre l'ampiezza della ricerca.
Il sito docs.sun.com visualizza un elenco di manuali contenenti la parola o la frase ricercata in ordine decrescente di rilevanza; il grado di rilevanza di un manuale è indicato dalle seguenti icone:
I documenti contrassegnati dall'icona presentano il maggiore grado di rilevanza rispetto ai criteri di ricerca.
I documenti contrassegnati dall'icona presentano il minore grado di rilevanza rispetto ai criteri di ricerca.
Il nome della collezione in cui il manuale è incluso viene visualizzato sotto il titolo del manuale, dopo la parola “da”.
Se vengono ricercate più parole contemporaneamente, i manuali in cui tali parole appaiono una accanto all'altra sono visualizzati per primi nell'elenco; i manuali in cui tali parole appaiono separate, con una distanza massima di 30 parole, sono visualizzati per ultimi.
I manuali che contengono le parole o le frasi ricercate nel titolo di un capitolo o di una sezione, o altri elementi simili in un manuale, sono caratterizzati da una maggiore rilevanza; questi manuali saranno tendenzialmente visualizzati più in alto nell'elenco rispetto ai manuali che contengono la stessa frequenza di parole o frasi ma nei paragrafi anziché nei titoli.
Se si esegue una ricerca sul sito Web docs.sun.com in una lingua straniera, i manuali scritti in tale lingua appaiono nella parte superiore dell'elenco attuale. Se, ad esempio, si visualizza il contenuto del sito docs.sun.com in francese, nella ricerca di una parola o di una frase i manuali scritti in francese appaiono nella parte superiore dell'elenco attuale.
Quando si effettua una ricerca globale, il sito docs.sun.com ignora manuali e collezioni che richiedono una password di accesso; una volta fornita la password, tuttavia, è possibile effettuare ricerche locali a condizione che si tratti di un manuale basato su XML.
Mentre tutti i manuali sono ugualmente considerati quando si effettua una ricerca globale o quando si utilizza il menu Ricerca in, le ricerche locali sono possibili solo all'interno dei manuali basati su XML. non è possibile effettuare ricerche all'interno dei documenti HTML o dei manuali solo PDF.
Quando sul sito Web docs.sun.com viene aperto un manuale e si ricercano informazioni al suo interno, è visualizzato un sommario del manuale con una serie di icone che indicano il grado di rilevanza dei vari elementi.
Un elemento (capitolo, appendice, prefazione, glossario o indice) contrassegnato dall'icona presenta il maggiore grado di rilevanza rispetto ai criteri di ricerca.
Un elemento (capitolo, appendice, prefazione, glossario o indice) contrassegnato dall'icona presenta il minore grado di rilevanza rispetto ai criteri di ricerca.
Gli elementi di un manuale privi di rilevanza non sono contrassegnati da alcuna icona.
Le parole ricercate all'interno dei manuali basati su XML sono evidenziate: in tal modo è possibile effettuare ricerche all'interno di un manuale e consultarlo allo stesso tempo.
Lo strumento di consultazione disponibile sul sito Web docs.sun.com consente anche di effettuare ricerche nei titoli, negli argomenti o nei prodotti.
Per restringere, ad esempio, l'insieme di documenti in cui ricercare una parola, occorre selezionare la scheda Prodotto, quindi fare clic sui collegamenti Software, Solaris, Solaris 8, Solaris 8 System Administrator Collection, e infine digitare nella casella Ricerca la parola che si desidera ricercare all'interno della collezione. Quando un manuale presente nella collezione viene consultato e aperto, la parola risulta evidenziata all'interno del testo.
La tabella seguente fornisce esempi di sintassi di ricerca.
Tabella 2-1 Esempi di sintassi di ricerca