Configurazione Scaladoc SBT

Sto provando a configurare lo Scaladoc in SBT, in particolare il titolo, la directory di output e il classpath.Configurazione Scaladoc SBT

sono riuscito a definire il titolo aggiungendo la seguente al build.sbt:

scalacOptions in (Compile, doc) ++= Opts.doc.title("Scala-Tools")

io non riesco a capire come cambiare la directory di output doc.

Inoltre non riesco a capire come aggiungere i jar al classpath. La ragione per cui voglio modificare il classpath è perché sembra che la libreria standard di Scala non venga rilevata da scaladoc quando faccio riferimento alle sue classi, cioè [[scala.Option]] porta a un avviso "Impossibile trovare alcun membro da collegare per "scala.Option". "

Qualsiasi aiuto, anche sotto forma di configurazione SBT di esempio, sarebbe apprezzato!

Sto utilizzando Scala 2.10-RC3 e SBT 0.12.1.

fonte

2012-12-10 user510159

La libreria Scala è sul classpath, altrimenti lo scaladoc si risolverebbe con un errore piuttosto rapidamente. L'avviso che vedi significa che lo scaladoc non sa come collegarsi all'opzione. A tal fine, è necessario utilizzare l'opzione -external-urls o l'opzione -doc-external-doc in entrata in 2.10.1. L'uscita del scaladoc -help per la prossima 2.10.1 mostra:

-doc-external-doc:<external-doc> comma-separated list of classpath_entry_path#doc_URL pairs describing external dependencies. 
-external-urls:<externalUrl(s)> (deprecated) comma-separated list of package_names=doc_URL for external dependencies, where package names are ':'-separated

La soluzione fino a 2.10.1 è fuori è quello di utilizzare -external-uris:

-external-urls:scala=http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/

fonte

2012-12-12 03:10:11

Grazie Marco! Tuttavia, usando questa soluzione, ottengo un errore: 'Impossibile trovare il file sorgente [error] 'http://www.scala-lang.org/archives/downloads/distrib/files/nightly/docs/library/'. – user510159

Inoltre, guardando 'scaladoc -help', non riesco a trovare nulla riguardo alla directory di output (l'altra parte della mia domanda). – user510159

Dovresti mostrare come stai passando. L'ho provato dalla riga di comando prima di postare e ha funzionato. Il messaggio di errore sembra implicare che viene interpretato come un file sorgente. Per quanto riguarda la modifica della directory di output, è l'opzione '-d' sulla riga di comando, ma sbt la gestisce per te con l'impostazione' docDirectory in Compile' (o 'in Test'). Perché vuoi cambiare la directory di output, però? –

risposta

Problemi correlati