Skip to content

Create a PDF file from Markdown documents (md2pdf) #11257

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 187 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
187 commits
Select commit Hold shift + click to select a range
067a4d7
add pandoc subproject (md2pdf)
michelou Jan 30, 2021
e7cfae3
Merge branch 'scala3-pandoc' of https://github.com/michelou/dotty int…
michelou Jan 30, 2021
3a442e2
updated shell script 'build'
michelou Jan 30, 2021
6dfa925
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 2, 2021
8e634ac
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 4, 2021
2277b00
addressed subset of review comments
michelou Feb 4, 2021
8a0660b
Add regression tests for #9283 #9284 #9288 #9293
griggt Jan 30, 2021
af60155
Add regression test for #2941
griggt Jan 31, 2021
1388371
Update CI status badge URL to reflect workflow name change
griggt Jan 30, 2021
761b98e
Feature GADT support for class type parameters
Ang9876 Jan 26, 2021
7999636
Update compiler/src/dotty/tools/dotc/typer/Typer.scala
Ang9876 Jan 28, 2021
d899873
Fix CI failure in [test_windows_full]
nicolasstucki Feb 1, 2021
b55aae5
Disable some scala3doc tests in Windows CI
nicolasstucki Feb 1, 2021
0b7a4f6
pages for enums
romanowski Feb 1, 2021
7620508
Make sure language imports are detectable syntactically
odersky Jan 21, 2021
63430b9
Simplifications
odersky Jan 23, 2021
2e25572
Add mode bit to track whether we are in safe nulls mode
odersky Jan 23, 2021
00e087b
Refine initial SafeNulls setting
odersky Jan 31, 2021
ce9fe32
Fix deprecation for java.lang.Deprecated
BarkingBad Jan 26, 2021
97b9b8a
Apply requested changes
BarkingBad Feb 1, 2021
1e24baf
Widen irreducible match type aliases to their bounds
odersky Jan 31, 2021
c27e3bb
Apply suggestions from code review
nicolasstucki Feb 1, 2021
c917f26
Make sure language imports are detectable syntactically
odersky Feb 1, 2021
9dbb155
Rename the setting -noindent into -no-indent.
sjrd Dec 4, 2020
1bcca9e
Fix Java 8 CI
nicolasstucki Feb 2, 2021
5d28c9f
Use all available context info for healing ambiguous implicits
odersky Feb 1, 2021
a9ee311
Drop ConstraintResultDeep mode
odersky Feb 2, 2021
d94ea36
Address review comments
odersky Feb 3, 2021
251d436
Upgrade to ASM 9.0
smarter Feb 2, 2021
db6f2f5
Update context-functions-spec.md
costa100 Nov 23, 2020
f7a0667
Fix #10788: Parsing arguments for java annotations
Kordyjan Jan 7, 2021
0314c1e
Skip java annotations with complex args in parser
Kordyjan Jan 13, 2021
ee68a15
Remove JavaAnnotationArg context property§
Kordyjan Feb 3, 2021
fe6a1ed
Wrap typed tree in special case for java annotation args
Kordyjan Feb 3, 2021
67b6a8c
Implement bean property generation
Kordyjan Nov 30, 2020
b8aab0b
Basic test case
Kordyjan Dec 1, 2020
81e7d81
Add test for overriding bean property
Kordyjan Dec 2, 2020
4dfdc10
Add filtering out synthetic accessors from unpickled templates
Kordyjan Dec 3, 2020
1ef4b83
Remove Permanent flag from sythetic accessors
Kordyjan Dec 3, 2020
15fb83b
Fix missing coordinates
Kordyjan Dec 7, 2020
0d7ef9c
Apply suggestions from code review for bean properties accessors
Kordyjan Feb 3, 2021
5bf10b7
Update base version
nicolasstucki Feb 2, 2021
e75021d
Use p* for vararg patterns
odersky Jan 28, 2021
e2ca8fe
Use p* for vararg splices in expressions
odersky Jan 28, 2021
5c6bac8
Update tests to use new syntax
odersky Jan 28, 2021
2b0fb76
Allow rewriting `x: _*` to `x*`
odersky Jan 28, 2021
bcec9f2
Update docs
odersky Jan 28, 2021
238f593
Update check file
odersky Jan 28, 2021
dbebfe4
Update compiler/src/dotty/tools/dotc/parsing/Parsers.scala
odersky Feb 3, 2021
4fd99b8
Fix typo 'Deprectated' -> 'Deprecated'
Philippus Feb 3, 2021
0e83880
fix type parameter name
Feb 4, 2021
779ffa5
Scala3doc: improve member lookup
abgruszecki Feb 3, 2021
ba9990d
Heal type of UnApply in quotes
nicolasstucki Feb 3, 2021
ab6961a
remove dotty.dokka.model.api package
romanowski Feb 1, 2021
451c352
Clean up files locations and directories
romanowski Feb 1, 2021
b62f98c
Cleanup test packages
romanowski Feb 1, 2021
18d267b
rename scala3doc into scaladoc
romanowski Feb 1, 2021
d43588b
rename dotty.dokka package into dotty.tools.scaladoc
romanowski Feb 1, 2021
d6f5b13
Rename scala3doc to scaladoc in sbt plugin
romanowski Feb 2, 2021
497b04f
Fix incorrect renames and spelling
romanowski Feb 3, 2021
2003757
Fix inferView on TermRef of Null
noti0na1 Feb 4, 2021
2acb641
Update creator-applications.md
Flowdalic Jan 18, 2021
9822973
Compactify names when flattening, to limit length of classfile names
griggt Feb 2, 2021
6383e62
Add scala2-compat test
griggt Feb 3, 2021
c725883
Don't compactify Java inner class names
griggt Feb 3, 2021
45f1157
Keep the length of class file names in tests within Docker/aufs limits
griggt Feb 4, 2021
cca0aef
LambdaLift: reload non-sym denotations when needed
smarter Feb 3, 2021
4681407
Add regression test for #10366
griggt Feb 5, 2021
145899b
Fix broken link to 'By Name Context Parameters' page
AugustNagro Feb 5, 2021
25ee815
Fix a typo in TestTest docs
dwijnand Feb 4, 2021
8291e51
Add perspective to the community build (#10750)
Katrix Feb 5, 2021
15d4ba1
Don't use suffix `_` in eta expansion
odersky Feb 4, 2021
3130926
Fix source version for test
odersky Feb 5, 2021
ff5f7e9
Use `notInitialized` for wildcard initializers
odersky Jan 27, 2021
414fd97
Deprecate `= _` under source 3.1
odersky Jan 27, 2021
0e9b758
Rename notInitialized to uninitialized
odersky Jan 27, 2021
24cc317
Change context-free syntax to reflect elimination of `= _`
odersky Jan 27, 2021
9c85ebb
Clarify docs
odersky Jan 31, 2021
f9fc161
Address review comments
odersky Feb 3, 2021
ca39802
Change tests to new syntax
odersky Feb 4, 2021
15f7ae4
Update compiler/src/dotty/tools/dotc/parsing/Parsers.scala
odersky Feb 5, 2021
9ff0d4c
rebased
michelou Feb 5, 2021
f8be8f2
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 5, 2021
5ac7adc
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 7, 2021
d15a234
added section wildcard-init.md'
michelou Feb 7, 2021
9b85042
updated data/usage.md
michelou Feb 7, 2021
a1a5a0a
added section 'Imports'
michelou Feb 8, 2021
e38d4b7
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 8, 2021
8fe4593
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 10, 2021
77ea171
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 12, 2021
0ccbee8
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 12, 2021
c61b09b
Merge branch 'scala3-pandoc' of https://github.com/michelou/dotty int…
michelou Feb 12, 2021
825cfcc
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 17, 2021
804f005
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 21, 2021
d2be290
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 26, 2021
e7fe9eb
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Feb 26, 2021
6d97268
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 1, 2021
7e0fe06
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 1, 2021
7d47860
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 2, 2021
b03a9a6
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 3, 2021
645a233
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 3, 2021
7cccddd
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 4, 2021
f4306e2
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 4, 2021
808b1a7
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 6, 2021
035e081
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 6, 2021
524b034
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 11, 2021
8e51561
sync with upstream
michelou Mar 11, 2021
eca1e51
Fix formatting
romanowski Mar 11, 2021
73c8ea9
Add top level index page
romanowski Mar 2, 2021
0e491f7
Fix two links in the Explicit Nulls doc
ShapelessCat Mar 12, 2021
ece8b34
Add missing suffixes
nicolasstucki Mar 11, 2021
3776afb
Upgrade JLine to 3.19.0
griggt Mar 12, 2021
aa0b9b4
Fix #9776: Don't issue a @switch warning when fewer than 4 cases
griggt Sep 22, 2020
4579509
Fix @switch warnings for matches on value classes
griggt Sep 25, 2020
a614d79
GADTs: widen only top-level variant params
abgruszecki Mar 12, 2021
2322fe9
Check conformance of trait and class parameters of base types
b-studios Jan 11, 2021
98c8977
reduced number of Logarithm
xhudik Mar 9, 2021
d155c65
fixed: Logarithms->MyMaths in text
xhudik Mar 12, 2021
6d51056
more fixes in Markdown files
michelou Mar 13, 2021
4438273
Add TypeTest to sidebar on website
bishabosha Mar 10, 2021
ea79336
Update sidebar.yml
bishabosha Mar 11, 2021
161cd41
Cleanup Namer#valOrDefDefSig#inferredType
smarter Mar 11, 2021
0f33822
Improve our ability to override default parameters
smarter Mar 11, 2021
f27d3c9
Fix variance checking in default getters
smarter Mar 12, 2021
ede1a50
Add Conversion.into method
odersky Mar 9, 2021
3339c92
Add doc comments on Conversion methods
odersky Mar 9, 2021
ca07eb3
Update CompletionTest
odersky Mar 9, 2021
ded06b0
Rename `into` to `convert`
odersky Mar 10, 2021
02b86cc
Fix name in comments
odersky Mar 10, 2021
53a5189
Bump sbt to 1.4.9
griggt Mar 15, 2021
8a21460
Update ScAS : remove implicit conversions
rjolly Mar 2, 2021
d65b62c
Make output match the example program
rbonvall Mar 14, 2021
fef312e
Fix #11654: disable pickling test for language.scala
liufengyun Mar 9, 2021
e1b045f
Add GADT test for upcasting
Linyxus Feb 24, 2021
89585c9
Consider all parents when upcasting
Linyxus Feb 24, 2021
2f29d69
Remove useless trace and add existence checking
Linyxus Mar 12, 2021
6eb5f21
Define repl as an alias of scala-compiler-bootstrapped/console
adpi2 Mar 15, 2021
244e976
Allow for missing type symbols in needsRewire
odersky Mar 15, 2021
cd3dc3a
Survive competing methods with select names _1, _2, ...
odersky Mar 14, 2021
fcffed6
Fix desugaring of context bounds in extensions
rjolly Mar 4, 2021
ed985ca
Add quotes.Type.valueOfConstant
nicolasstucki Mar 12, 2021
f4fa164
Print complete extractor for reflect TypeLambda
nicolasstucki Mar 15, 2021
cc1892d
Cleanup sourcecode of Quotes
nicolasstucki Mar 15, 2021
99223f4
Move to sbt slash syntax
adpi2 Mar 15, 2021
a905547
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 15, 2021
4950820
Revert "Fix desugaring of context bounds in extensions"
bishabosha Mar 15, 2021
c011ada
Fix clear_out() not deleting files in cmdTests
griggt Mar 9, 2021
c95ee93
Fix broken dotty.tools.io.Path#parent
griggt Mar 8, 2021
b06a689
Don't normalize paths in Path#parent
griggt Mar 11, 2021
52ddedb
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 16, 2021
f4ab2cf
sync with upstream
michelou Mar 22, 2021
511882e
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 27, 2021
f6902bb
Merge branch 'scala3-pandoc' of https://github.com/michelou/dotty int…
michelou Mar 30, 2021
235a364
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Mar 30, 2021
01bc30c
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Apr 6, 2021
9154836
sync with upstream
michelou Apr 6, 2021
eb2b1ad
Merge remote-tracking branch 'upstream/master' into scala3-pandoc
michelou Apr 6, 2021
93670ff
Allow by-name types in using clauses
odersky Apr 6, 2021
144100c
Merge branch 'master' of https://github.com/lampepfl/dotty into scala…
michelou Apr 6, 2021
bebf97a
Streamline flag checking
odersky Apr 6, 2021
2b9311a
Revert "Recursively check nonvariant arguments of base types for real…
odersky Apr 6, 2021
d976fe3
Add test
odersky Apr 6, 2021
39094b1
Make community build docs experiment-aware
abgruszecki Mar 29, 2021
8b28db5
Community build: tag scas as not requiring experimental
abgruszecki Apr 6, 2021
888828c
bump sbt to 1.5.0
adpi2 Mar 22, 2021
bed2c9d
Use sbt slash syntax
adpi2 Apr 7, 2021
ba7f121
Fix minitest doc command
adpi2 Apr 7, 2021
e510487
Merge remote-tracking branch 'upstream/master' into HEAD
michelou Apr 14, 2021
ab22bed
Add TermParamClause.isGiven
nicolasstucki Apr 8, 2021
ec29ddf
Add `TermParamClause.isErased`
nicolasstucki Apr 9, 2021
2354dbc
Add @covers annotation
liufengyun Jan 21, 2021
7de8074
Make TypeTest.unapply conditionally irrefutable
liufengyun Apr 12, 2021
8a83a70
Fix type test for trait parameter arguments
odersky Apr 9, 2021
4f4598a
Run scripted with sbt 1.5
adpi2 Apr 12, 2021
eda52b6
Use Mill 0.9.6-16-a5da34
adpi2 Apr 13, 2021
e8797ff
updated external links to docs.scala-lang.org
michelou Jul 23, 2021
6efbda4
updated files pandoc.yaml and reference.md
michelou Jan 2, 2022
60af122
fixed branch
michelou Jan 2, 2022
b7f64a9
prints version
michelou Jan 2, 2022
67e85ae
chmod +x
michelou Jan 2, 2022
0b53581
prints version (cnt'd)
michelou Jan 2, 2022
83e7ad9
added printenv job
michelou Jan 2, 2022
4cd7159
updated .md files, updated pandoc.yaml
michelou Jan 2, 2022
3e7db05
bash -> sh
michelou Jan 2, 2022
5de9c72
updated shell scripts (bash->sh, fonts)
michelou Jan 4, 2022
d4e7651
install additional TeX fonts
michelou Jan 4, 2022
959b112
updated file reference.md
michelou Feb 18, 2022
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
rename scala3doc into scaladoc
  • Loading branch information
romanowski authored and michelou committed Feb 5, 2021
commit 18d267b5bfe4f0782546c5cc09e794f645f0a13a
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: Scala3doc
name: scaladoc

on:
push:
Expand All @@ -12,7 +12,7 @@ jobs:
&& !contains(github.event.pull_request.body, '[skip ci]')
&& !contains(github.event.pull_request.body, '[skip docs]')
)
|| contains(github.event.ref, 'scala3doc')
|| contains(github.event.ref, 'scaladoc')
|| contains(github.event.ref, 'master')"

steps:
Expand All @@ -36,25 +36,25 @@ jobs:
java-version: 11

- name: Compile and test
run: ./project/scripts/sbt scala3doc/test
run: ./project/scripts/sbt scaladoc/test

- name: Locally publish self
run: ./project/scripts/sbt scala3doc/publishLocal
run: ./project/scripts/sbt scaladoc/publishLocal

- name: Generate self documentation
run: ./project/scripts/sbt scala3doc/generateSelfDocumentation
run: ./project/scripts/sbt scaladoc/generateSelfDocumentation

- name: Generate testcases documentation
run: ./project/scripts/sbt scala3doc/generateTestcasesDocumentation
run: ./project/scripts/sbt scaladoc/generateTestcasesDocumentation

- name: Generate Scala 3 documentation
run: ./project/scripts/sbt scala3doc/generateScala3Documentation
run: ./project/scripts/sbt scaladoc/generatescaladocumentation

- name: Generate documentation for example project using dotty-sbt
run: ./project/scripts/sbt "sbt-dotty/scripted sbt-dotty/scala3doc"
run: ./project/scripts/sbt "sbt-dotty/scripted sbt-dotty/scaladoc"

- name: Generate index file
run: scala3doc/scripts/mk-index.sh scala3doc/output > scala3doc/output/index.html
run: scaladoc/scripts/mk-index.sh scaladoc/output > scaladoc/output/index.html

- name: Upload documentation to server
uses: azure/CLI@v1
Expand All @@ -64,9 +64,9 @@ jobs:
with:
inlineScript: |
DOC_DEST=pr-${PR_NUMBER:-${GITHUB_REF##*/}}
echo uplading docs to https://scala3doc.virtuslab.com/$DOC_DEST
az storage container create --name $DOC_DEST --account-name scala3docstorage --public-access container
az storage blob sync -s scala3doc/output -c $DOC_DEST --account-name scala3docstorage
echo uplading docs to https://scaladoc.virtuslab.com/$DOC_DEST
az storage container create --name $DOC_DEST --account-name scaladocstorage --public-access container
az storage blob sync -s scaladoc/output -c $DOC_DEST --account-name scaladocstorage

community-docs:
env:
Expand All @@ -76,7 +76,7 @@ jobs:
&& !contains(github.event.pull_request.body, '[skip ci]')
&& !contains(github.event.pull_request.body, '[skip docs]')
)
|| contains(github.event.ref, 'scala3doc')
|| contains(github.event.ref, 'scaladoc')
|| contains(github.event.ref, 'master')"

steps:
Expand All @@ -102,6 +102,6 @@ jobs:
with:
inlineScript: |
DOC_DEST=pr-${PR_NUMBER:-${GITHUB_REF##*/}}-docs
echo uplading docs to https://scala3doc.virtuslab.com/$DOC_DEST
az storage container create --name $DOC_DEST --account-name scala3docstorage --public-access container
az storage blob sync -s community-build/docsOutput -c $DOC_DEST --account-name scala3docstorage
echo uplading docs to https://scaladoc.virtuslab.com/$DOC_DEST
az storage container create --name $DOC_DEST --account-name scaladocstorage --public-access container
az storage blob sync -s community-build/docsOutput -c $DOC_DEST --account-name scaladocstorage
6 changes: 3 additions & 3 deletions build.sbt
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,9 @@ val `stdlib-bootstrapped-tasty-tests` = Build.`stdlib-bootstrapped-tasty-tests`
val `tasty-core` = Build.`tasty-core`
val `tasty-core-bootstrapped` = Build.`tasty-core-bootstrapped`
val `tasty-core-scala2` = Build.`tasty-core-scala2`
val scala3doc = Build.scala3doc
val `scala3doc-testcases` = Build.`scala3doc-testcases`
val `scala3doc-js` = Build.`scala3doc-js`
val scaladoc = Build.scaladoc
val `scaladoc-testcases` = Build.`scaladoc-testcases`
val `scaladoc-js` = Build.`scaladoc-js`
val `scala3-bench-run` = Build.`scala3-bench-run`
val dist = Build.dist
val `community-build` = Build.`community-build`
Expand Down
2 changes: 1 addition & 1 deletion community-build/src/scala/dotty/communitybuild/Main.scala
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ object Main:
val name = project.project
try
project.doc()
val pathsOut = s"find community-projects/$name/ -name 'scala3doc.version'".!!
val pathsOut = s"find community-projects/$name/ -name 'scaladoc.version'".!!
pathsOut.linesIterator.map(Paths.get(_).getParent).toList
catch
case e: Exception =>
Expand Down
4 changes: 2 additions & 2 deletions community-build/src/scala/dotty/communitybuild/projects.scala
Original file line number Diff line number Diff line change
Expand Up @@ -162,12 +162,12 @@ final case class SbtCommunityProject(

override val publishCommand = if sbtPublishCommand eq null then null else
val disableDocCommand =
if sbtDocCommand eq null then "" else "set every useScala3doc := false;"
if sbtDocCommand eq null then "" else "set every usescaladoc := false;"
s"$baseCommand$disableDocCommand$sbtPublishCommand"
override val docCommand =
if sbtDocCommand eq null then null else
val cmd = if sbtDocCommand.startsWith(";") then sbtDocCommand else s";$sbtDocCommand"
s"$baseCommand set every useScala3doc := true; set every doc/logLevel := Level.Warn $cmd "
s"$baseCommand set every usescaladoc := true; set every doc/logLevel := Level.Warn $cmd "

override val runCommandsArgs: List[String] =
// Run the sbt command with the compiler version and sbt plugin set in the build
Expand Down
4 changes: 2 additions & 2 deletions compiler/src/dotty/tools/dotc/config/ScalaSettings.scala
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import PathResolver.Defaults
import rewrites.Rewrites
import Settings.Setting

/** Settings shared by compiler and scala3doc */
/** Settings shared by compiler and scaladoc */
trait CommonScalaSettings { self: Settings.SettingGroup =>
protected def defaultClasspath: String = sys.env.getOrElse("CLASSPATH", ".")

Expand Down Expand Up @@ -227,7 +227,7 @@ class ScalaSettings extends Settings.SettingGroup with CommonScalaSettings {
val Yinstrument: Setting[Boolean] = BooleanSetting("-Yinstrument", "Add instrumentation code that counts allocations and closure creations.")
val YinstrumentDefs: Setting[Boolean] = BooleanSetting("-Yinstrument-defs", "Add instrumentation code that counts method calls; needs -Yinstrument to be set, too.")

/** Dottydoc specific settings that are not used in scala3doc */
/** Dottydoc specific settings that are not used in scaladoc */
val docSnapshot: Setting[Boolean] = BooleanSetting("-doc-snapshot", "Generate a documentation snapshot for the current Dotty version")

val projectUrl: Setting[String] = StringSetting (
Expand Down
4 changes: 2 additions & 2 deletions docs/blog/_posts/2020-12-18-scala3-m3.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,9 +133,9 @@ You can read the discussion of this change in the [PR #10670](https://github.com
# Tooling improvements
As we are getting closer to a stable release of Scala 3, the focus increasingly shifts on the tooling available to get started with Scala 3.

For a while now, we are not using the old dottydoc documentation tool for building the documentation. We are developing an entirely new tool, scala3doc, from scratch. This new documentation tool is more robust and faster than the old one.
For a while now, we are not using the old dottydoc documentation tool for building the documentation. We are developing an entirely new tool, scaladoc, from scratch. This new documentation tool is more robust and faster than the old one.

As part of the tooling effort, this new Scala 3 documentation tool is rapidly improved. [PR #10522](https://github.com/lampepfl/dotty/pull/10522) proves that the doctool can generate documentation for the community build projects. You can access this documentation via the following [link](https://scala3doc.virtuslab.com/pr-master-docs/index.html).
As part of the tooling effort, this new Scala 3 documentation tool is rapidly improved. [PR #10522](https://github.com/lampepfl/dotty/pull/10522) proves that the doctool can generate documentation for the community build projects. You can access this documentation via the following [link](https://scaladoc.virtuslab.com/pr-master-docs/index.html).

[PR #10491](https://github.com/lampepfl/dotty/pull/10491) introduced scripting support in Scala 3. Consider the following source named `Main.scala`:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@ title: Built-in blog

# {{page.title}}

Scala3doc allows you to include a simple blog in your documentation. For now, it
scaladoc allows you to include a simple blog in your documentation. For now, it
provides only basic features. In the future, we plan to include more advanced
features like tagging or author pages.
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: API Documentation

# {{ page.title }}

Scala3doc's main feature is creating API documentation from code comments.
scaladoc's main feature is creating API documentation from code comments.

By default, the code comments are understood as Markdown, though we also support
Scaladoc's old [Wiki syntax](https://docs.scala-lang.org/style/scaladoc.html).
Expand Down Expand Up @@ -75,7 +75,7 @@ closer together. The new features are:
def foo = `([.abusive.])`
```
Scaladoc required backslash-escaping to reference such identifiers. Instead,
Scala3doc allows using the familiar Scala backtick quotation.
scaladoc allows using the familiar Scala backtick quotation.

#### Why keep the Wiki syntax for links?

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Scala3doc
title: scaladoc
---

![Scala3doc logo](/images/scala3doc-logo.png)
![scaladoc logo](/images/scaladoc-logo.png)

Scala3doc is tool to generate documentation for your Scala 3 projects. It provies similar features to `javadoc` or `scaladoc` as well as `jekyll` or `docusaurus`.
scaladoc is tool to generate documentation for your Scala 3 projects. It provies similar features to `javadoc` or `scaladoc` as well as `jekyll` or `docusaurus`.

As you probably have guessed, this whole site was created using Scala3doc.
As you probably have guessed, this whole site was created using scaladoc.


{% for post in site.posts %}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: Scala3doc-specific Tags and Features
title: scaladoc-specific Tags and Features
---

# {{page.title}}

Scala3doc extends Markdown with additional features, such as linking
scaladoc extends Markdown with additional features, such as linking
to API definitions. This can be used from within static documentation and blog
posts to provide blend-in content.

## Linking to API

Scala3doc allows linking to API documentation with Wiki-style links. Linking to
scaladoc allows linking to API documentation with Wiki-style links. Linking to
`scala.collection.immutable.List` is as simple as
`[[scala.collection.immutable.List]]`. For more information on the exact syntax, see [doc comment documentation](./docComments.html#definition-links).
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Static documentation

# {{ page.title}}

Scala3doc is able to generate static sites, known from [Jekyll](http://jekyllrb.com/) or [Docusaurus](https://docusaurus.io/).
scaladoc is able to generate static sites, known from [Jekyll](http://jekyllrb.com/) or [Docusaurus](https://docusaurus.io/).
Having a combined tool allows to provide interaction between static documentation and API, thus allowing the two to blend naturally.

Creating a site is just as simple as in Jekyll. The site root contains the
Expand All @@ -29,18 +29,18 @@ index.html
docs/getting-started.html
```

Scala3doc can transform both files and directories (to organize your documentation into tree-like structure). By default directories has title based on file name and has empty content. There is an option to include `index.html` or `index.md` (not both) to provide both content and properties like title (see [Properties](#properties)).
scaladoc can transform both files and directories (to organize your documentation into tree-like structure). By default directories has title based on file name and has empty content. There is an option to include `index.html` or `index.md` (not both) to provide both content and properties like title (see [Properties](#properties)).

## Properties

Scala3doc uses the [Liquid](https://shopify.github.io/liquid/) templating engine
scaladoc uses the [Liquid](https://shopify.github.io/liquid/) templating engine
and provides a number of custom filters and tags specific to Scala
documentation.

In Scala3doc, all templates can contain YAML front-matter. The front-matter
In scaladoc, all templates can contain YAML front-matter. The front-matter
is parsed and put into the `page` variable available in templates via Liquid.

Scala3doc uses some predefined properties to controls some aspect of page.
scaladoc uses some predefined properties to controls some aspect of page.

Predefined properties:

Expand Down Expand Up @@ -94,7 +94,7 @@ Layouts must be placed in a `_layouts` directory in the site root:

Sidebar
=======
Scala3doc by default uses layout of files in `docs` directory to create table of content. There is also ability to override it by providing a `sidebar.yml` file in the site root:
scaladoc by default uses layout of files in `docs` directory to create table of content. There is also ability to override it by providing a `sidebar.yml` file in the site root:

```yaml
sidebar:
Expand Down
File renamed without changes
4 changes: 2 additions & 2 deletions docs/sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ sidebar:
url: docs/usage/language-versions.html
- title: cbt-projects
url: docs/usage/cbt-projects.html
- title: Scala3doc
url: docs/usage/scala3doc
- title: scaladoc
url: docs/usage/scaladoc
- title: Dottydoc [Legacy]
url: docs/usage/dottydoc.html
- title: Reference
Expand Down
Loading