Initial Journey: adding all examples from chisel-tutorial, as-is

def scalacOptionsVersion(scalaVersion: String): Seq[String] = {

  Seq() ++ {

    // If we're building with Scala > 2.11, enable the compile option

    //  switch to support our anonymous Bundle definitions:

    //  https://github.com/scala/bug/issues/10047

    CrossVersion.partialVersion(scalaVersion) match {

      case Some((2, scalaMajor: Int)) if scalaMajor < 12 => Seq()

      case _ => Seq("-Xsource:2.11")

    }

  }

}

def javacOptionsVersion(scalaVersion: String): Seq[String] = {

  Seq() ++ {

    // Scala 2.12 requires Java 8. We continue to generate

    //  Java 7 compatible code for Scala 2.11

    //  for compatibility with old clients.

    CrossVersion.partialVersion(scalaVersion) match {

      case Some((2, scalaMajor: Int)) if scalaMajor < 12 =>

        Seq("-source", "1.7", "-target", "1.7")

      case _ =>

        Seq("-source", "1.8", "-target", "1.8")

    }

  }

}

organization := "edu.berkeley.cs"

version := "3.0.0"

name := "chisel-tutorial"

scalaVersion := "2.11.11"

crossScalaVersions := Seq("2.11.11", "2.12.3")

scalacOptions ++= Seq("-deprecation", "-feature", "-unchecked", "-language:reflectiveCalls")

// Provide a managed dependency on X if -DXVersion="" is supplied on the command line.

// The following are the default development versions, not the "release" versions.

val defaultVersions = Map(

  "chisel3" -> "3.0.+",

  "chisel-iotesters" -> "1.1.+"

  )

libraryDependencies ++= (Seq("chisel3","chisel-iotesters").map {

  dep: String => "edu.berkeley.cs" %% dep % sys.props.getOrElse(dep + "Version", defaultVersions(dep)) })

resolvers ++= Seq(

  Resolver.sonatypeRepo("snapshots"),

  Resolver.sonatypeRepo("releases")

)

// Recommendations from http://www.scalatest.org/user_guide/using_scalatest_with_sbt

logBuffered in Test := false

// Disable parallel execution when running tests.

//  Running tests in parallel on Jenkins currently fails.

parallelExecution in Test := false

scalacOptions ++= scalacOptionsVersion(scalaVersion.value)

javacOptions ++= javacOptionsVersion(scalaVersion.value)

# Building the docs on osx will require to install Jinja2 and BeautifulSoup:

#     $ pip install Jinja2 BeautifulSoup

# and the different tools for text to pdf:

#     $ port install texlive-latex-extra texlive-latex-recommended \

#           texlive-htmlxml ImageMagick

#

# For building on Ubuntu 14.04 LTS, the following packages should be

# installed with "apt-get install":

#  python-bs4 imagemagick source-highlight tex4ht texlive-latex-base \

#  texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended \

#  texlive-fonts-extra

PDFLATEX  := pdflatex

WWW_PAGES :=

WWW_EXTRA :=

# The following subdirectories build documentation correctly.

PDF_DIRS	:= tutorial

# Define a function to map PDF_DIRS to a PDF base name.

# Basically, every directory is the base name of the pdf except for dac12-talk.

pdf_base_name_from_dir = $(subst talks/dac12,dac12-talk,$(1))

# Define a map function to apply a function to multiple arguments.

map = $(foreach arg,$(2),$(call $(1),$(arg)))

PDFS := $(addsuffix .pdf,$(addprefix chisel-,$(call map,pdf_base_name_from_dir,$(PDF_DIRS))))

# Suffixes for tex temporary files we'll clean

TEX_SUFFIXES := 4ct 4tc aux css dvi html idv lg log out tmp xref

TEX_TEMP_FILES := $(foreach dir,$(PDF_DIRS),$(foreach suffix,$(TEX_SUFFIXES),$(dir)/$(call pdf_base_name_from_dir,$(dir)).$(suffix)))

STY_TEMP_FILES := $(foreach dir,$(PDF_DIRS),$(dir)/$(call pdf_base_name_from_dir,$(dir))_date.sty)

LATEX2MAN := latex2man

MAN_PAGES := chisel.man

srcDir    := .

installTop:= ../www

toolDir	?= ../../chisel-doc/bin

vpath %.tex $(addprefix $(srcDir)/,$(PDF_DIRS))

vpath %.mtt $(addprefix $(srcDir)/,$(PDF_DIRS))

all: $(WWW_PAGES) $(WWW_EXTRA) $(PDFS)

extra: $(WWW_EXTRA)

html: $(WWW_PAGES)

pdf: $(PDFS)

install: all

# NOTE: We follow the recommended practice of running the *latex tools twice

# so references (citations and figures) are correctly handled.

# NOTE: There are problems with running pdflatex after htlatex due to the

# manual.aux file left over by the latter. We see:

#  ./manual.tex:113: Undefined control sequence.

#  <argument> ...tring :autoref\endcsname {\@captype 

#                                                    }1

#  l.113 Figure~\ref{fig:node-hierarchy}

# This was reported at:

# http://tex.stackexchange.com/questions/117802/running-pdflatex-after-htlatex-causes-hyperref-error-undefined-control-sequence

# but apparently went away after upgrading to texlive 2013.

# It fails on ubuntu 14.04 LTS and texlive-latex-recommended 2013.20140215-1

# if we don't remove the manual.aux file

chisel-%.pdf: %.tex %_date.sty

	rm -f $(subst .tex,.aux,$<)

	cd $(dir $<) && for c in 0 1; do pdflatex -file-line-error -interaction nonstopmode -output-directory $(PWD) $(notdir $<) ; done

	mv $(subst .tex,.pdf,$(notdir $<)) $@

%.html: %.tex %_date.sty

	cd $(dir $<) && for c in 0 1; do htlatex $(notdir $<) $(PWD)/$(srcDir)/html.cfg "" -d/$(PWD)/ ; done

	mv $(subst .tex,.html,$(notdir $<)) $@~

	$(toolDir)/tex2html.py $@~ $@

%.man: %.mtt

	# cd into the directory containing the .tex file and massage it

	cd $(dir $<) && \

	sed -e "s/@VERSION@/$(RELEASE_TAG)/" -e "s/@DATE@/$(RELEASE_DATE)/" $(notdir $<) > $(basename $@).ttex ;\

	latex2man $(basename $@).ttex $@

%.html: $(srcDir)/templates/%.html $(srcDir)/templates/base.html

	$(toolDir)/jinja2html.py $(notdir $<) $@

clean:

	-rm -f $(TEX_TEMP_FILES)

	-rm -f $(STY_TEMP_FILES)

	# Remove any .{png,graffle} files that are created from pdfs

	-rm -f $(foreach gext,png graffle,$(subst .pdf,.$(gext),$(wildcard tutorial/figs/*.pdf)))

	-rm -f $(WWW_PAGES) $(PDFS) $(WWW_EXTRA) $(addsuffix .1,$(WWW_EXTRA)) $(patsubst %.html,%.css,$(WWW_EXTRA))

	-rm -f *~ *.aux *.log *.nav *.out *.snm *.toc *.vrb

	-rm -f *.jpg *.png

# Generate a date (optional) for the document based on the latest

# git commit of any of its (obvious) constituent parts.

%_date.sty:	%.tex

	for f in $(wildcard $(dir $<)*.tex); do git log -n 1 --format="%at" -- $$f; done | sort -nr | head -1 | gawk '{print "\\date{",strftime("%B %e, %Y", $$1),"}"}' > $@

	cmp $@ $(dir $<)$@ || cp $@ $(dir $<)

\Preamble{xhtml}

  \Configure{graphics*}  

         {pdf}  

         {\Needs{"convert \csname Gin@base\endcsname.pdf  

                               \csname Gin@base\endcsname.png"}%  

          \Picture[pict]{\csname Gin@base\endcsname.png}%  

         }  

\begin{document}

\EndPreamble

% "define" Scala

\usepackage[T1]{fontenc}  

\usepackage[scaled=0.82]{beramono}  

\usepackage{microtype} 

\sbox0{\small\ttfamily A}

\edef\mybasewidth{\the\wd0 }

\lstdefinelanguage{scala}{

  morekeywords={abstract,case,catch,class,def,%

    do,else,extends,false,final,finally,%

    for,if,implicit,import,match,mixin,%

    new,null,object,override,package,%

    private,protected,requires,return,sealed,%

    super,this,throw,trait,true,try,%

    type,val,var,while,with,yield},

  sensitive=true,

  morecomment=[l]{//},

  morecomment=[n]{/*}{*/},

  morestring=[b]",

  morestring=[b]',

  morestring=[b]"""

}

\usepackage{color}

\definecolor{dkgreen}{rgb}{0,0.6,0}

\definecolor{gray}{rgb}{0.5,0.5,0.5}

\definecolor{mauve}{rgb}{0.58,0,0.82}

% Default settings for code listings

\lstset{frame=tb,

  language=scala,

  aboveskip=3mm,

  belowskip=3mm,

  showstringspaces=false,

  columns=fixed, % basewidth=\mybasewidth,

  basicstyle={\small\ttfamily},

  numbers=none,

  numberstyle=\footnotesize\color{gray},

  % identifierstyle=\color{red},

  keywordstyle=\color{blue},

  commentstyle=\color{dkgreen},

  stringstyle=\color{mauve},

  frame=single,

  breaklines=true,

  breakatwhitespace=true,

  procnamekeys={def, val, var, class, trait, object, extends},

  procnamestyle=\ttfamily\color{red},

  tabsize=2

}

\lstnewenvironment{scala}[1][]

{\lstset{language=scala,#1}}

{}

\lstnewenvironment{cpp}[1][]

{\lstset{language=C++,#1}}

{}

\lstnewenvironment{bash}[1][]

{\lstset{language=bash,#1}}

{}

\lstnewenvironment{verilog}[1][]

{\lstset{language=verilog,#1}}

{}

\lstset{basicstyle={\footnotesize\ttfamily}}

\usetheme[height=8mm]{Rochester}

\setbeamersize{text margin left=3mm} 

\setbeamersize{text margin right=3mm} 

\setbeamertemplate{navigation symbols}{}

\definecolor{Cobalt}{rgb}{0.25,0.125,0.70}

\definecolor{RedOrange}{rgb}{0.8,0.25,0.0}

% \definecolor{RedOrange}{rgb}{0.8,0.775,0.25}

\def\frametitledefaultcolor{Cobalt}

\def\frametitleproblemcolor{RedOrange}

\lstset{basicstyle={\footnotesize\ttfamily}}

\setbeamertemplate{frametitle}

{

\vskip-7mm

\textbf{\insertframetitle}\hfill\insertframenumber

}

\setbeamercolor{frametitle}{bg=\frametitledefaultcolor}

\newenvironment{sample}{\VerbatimEnvironment\begin{footnotesize}\begin{semiverbatim}}{\end{semiverbatim}\end{footnotesize}}

\newenvironment{FramedSemiVerb}%

{\begin{Sbox}\begin{minipage}{.94\textwidth}\begin{semiverbatim}}%

{\end{semiverbatim}\end{minipage}\end{Sbox}

\setlength{\fboxsep}{8pt}\fbox{\TheSbox}}

\newenvironment{FramedVerb}%

{\VerbatimEnvironment

\begin{Sbox}\begin{minipage}{.94\textwidth}\begin{Verbatim}}%

{\end{Verbatim}\end{minipage}\end{Sbox}

\setlength{\fboxsep}{8pt}\fbox{\TheSbox}}

% \newenvironment{sample}{\VerbatimEnvironment\begin{footnotesize}\begin{Verbatim}}{\end{Verbatim}\end{footnotesize}}

\newcommand{\code}[1]{\begin{footnotesize}{\tt #1}\end{footnotesize}}

\newcommand{\comment}[1]{{\color{Green}\it\smaller #1}}