scala.tools.nsc.doc

DocFactory

class DocFactory extends AnyRef

A documentation processor controls the process of generating Scala documentation, which is as follows.

* A simplified compiler instance (with only the front-end phases enabled) * is created, and additional sourceless comments are registered. * Documentable files are compiled, thereby filling the compiler's symbol table. * A documentation model is extracted from the post-compilation symbol table. * A generator is used to transform the model into the correct final format (HTML).

A processor contains a single compiler instantiated from the processor's settings. Each call to document uses the same compiler instance with the same symbol table. In particular, this implies that the scaladoc site obtained from a call to run will contain documentation about files compiled during previous calls to the same processor's run method.

Self Type
DocFactory
Linear Supertypes
AnyRef, Any
Type Hierarchy Learn more about scaladoc diagrams
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. DocFactory
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by any2stringfmt
  3. by any2ArrowAssoc
  4. by any2Ensuring
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Instance Constructors

  1. new DocFactory(reporter: Reporter, settings: Settings)

    reporter

    The reporter to which both documentation and compilation errors will be reported.

    settings

    The settings to be used by the documenter and compiler for generating documentation.

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. def +(other: String): String

    Implicit information
    This member is added by an implicit conversion from DocFactory to StringAdd performed by method any2stringadd in scala.Predef.
    Definition Classes
    StringAdd
  5. def ->[B](y: B): (DocFactory, B)

    Implicit information
    This member is added by an implicit conversion from DocFactory to ArrowAssoc[DocFactory] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  7. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  8. object NoCompilerRunException extends Throwable with ControlThrowable

  9. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  10. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  11. object compiler extends Global with RangePositions

    The unique compiler instance used by this processor and constructed from its settings.

  12. def document(files: List[String]): Unit

    Generate document(s) for all files containing scaladoc documenataion.

    Generate document(s) for all files containing scaladoc documenataion.

    files

    The list of paths (relative to the compiler's source path, or absolute) of files to document.

  13. val documentError: PartialFunction[Throwable, Unit]

  14. def ensuring(cond: (DocFactory) ⇒ Boolean, msg: ⇒ Any): DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to Ensuring[DocFactory] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: (DocFactory) ⇒ Boolean): DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to Ensuring[DocFactory] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. def ensuring(cond: Boolean, msg: ⇒ Any): DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to Ensuring[DocFactory] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  17. def ensuring(cond: Boolean): DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to Ensuring[DocFactory] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  18. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  19. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  20. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  21. def formatted(fmtstr: String): String

    Implicit information
    This member is added by an implicit conversion from DocFactory to StringFormat performed by method any2stringfmt in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  22. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  23. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  24. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  25. def makeUniverse(source: Either[List[String], String]): Option[Universe]

    Creates a scaladoc site for all symbols defined in this call's source, as well as those defined in sources of previous calls to the same processor.

    Creates a scaladoc site for all symbols defined in this call's source, as well as those defined in sources of previous calls to the same processor.

    source

    The list of paths (relative to the compiler's source path, or absolute) of files to document or the source code.

  26. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  27. final def notify(): Unit

    Definition Classes
    AnyRef
  28. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  29. val reporter: Reporter

    The reporter to which both documentation and compilation errors will be reported.

  30. val settings: Settings

    The settings to be used by the documenter and compiler for generating documentation.

  31. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  32. def toString(): String

    Definition Classes
    AnyRef → Any
  33. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  34. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  35. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  36. def [B](y: B): (DocFactory, B)

    Implicit information
    This member is added by an implicit conversion from DocFactory to ArrowAssoc[DocFactory] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Shadowed Implicit Value Members

  1. val self: Any

    Implicit information
    This member is added by an implicit conversion from DocFactory to StringAdd performed by method any2stringadd in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (docFactory: StringAdd).self
    Definition Classes
    StringAdd
  2. val self: Any

    Implicit information
    This member is added by an implicit conversion from DocFactory to StringFormat performed by method any2stringfmt in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (docFactory: StringFormat).self
    Definition Classes
    StringFormat

Deprecated Value Members

  1. def x: DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to ArrowAssoc[DocFactory] performed by method any2ArrowAssoc in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (docFactory: ArrowAssoc[DocFactory]).x
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use leftOfArrow instead

  2. def x: DocFactory

    Implicit information
    This member is added by an implicit conversion from DocFactory to Ensuring[DocFactory] performed by method any2Ensuring in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (docFactory: Ensuring[DocFactory]).x
    Definition Classes
    Ensuring
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use resultOfEnsuring instead

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from DocFactory to StringAdd

Inherited by implicit conversion any2stringfmt from DocFactory to StringFormat

Inherited by implicit conversion any2ArrowAssoc from DocFactory to ArrowAssoc[DocFactory]

Inherited by implicit conversion any2Ensuring from DocFactory to Ensuring[DocFactory]

Ungrouped