Skip to content
Browse files

Minor cleanups for github repository.

  • Loading branch information...
wsnyder committed Oct 26, 2019
1 parent 719f34b commit 61810d6cf73dc589b49ef474b2d249c758c612c8
@@ -1,15 +1,21 @@
@@ -2,6 +2,10 @@ Revision history for Dinotrace

The contributors that suggested a given feature are shown in [].

* Dinotrace 9.4f devel

**** Minor cleanups for github repository.

* Dinotrace 9.4e 2016/11/24

**** Fix clang compiler warnings.
@@ -1033,7 +1037,7 @@ The contributors that suggested a given feature are shown in [].

**** Known bug: will crash in File->Select when filtering with long
filters ( toolkit problem??? )


This uses outline mode in Emacs. See C-h m [M-x describe-mode].
@@ -5,7 +5,7 @@
# Author: Wilson Snyder <>
# Code available from:
# Code available from:
MAKEINFO = makeinfo
TEXI2DVI = texi2dvi
ASCIIDOCTOR = asciidoctor

#### Don't edit: You're much better using configure switches to set these
@@ -93,7 +94,7 @@ SHELL = /bin/sh

SUBDIRS = src lisp

INFOS = INSTALL FAQ dinotrace.txt
INFOS = dinotrace.txt dinotrace.pdf

CPPCHECK = cppcheck
CPPCHECK_FLAGS = --enable=all --suppress=variableScope --inline-suppr
@@ -102,15 +103,22 @@ CPPCHECK_FLAGS = --enable=all --suppress=variableScope --inline-suppr
DISTDEP = $(INFOS) Makefile src/ src/
# Files to distribute.
DISTBIN = $(wildcard bin/dinotrace-*)
DISTFILES = $(INFOS) COPYING Changes TODO configure *.in *.ac \
DISTFILES = $(INFOS) COPYING Changes configure *.in *.ac \
config.sub \
install-sh mkinstalldirs *.texi *.com \
html_texi_clean \
*.adoc \
docs/*.adoc \
docs/*.png \
docs/TODO.txt \
docs/html_texi_clean \
src/*.in src/*.h src/*.c src/*.pl src/*.com lisp/* traces/* \

all: dinotrace_exe info

test: dinotrace_exe
./dinotrace traces/ascii.tra

-mkdir -p $@
@@ -148,20 +156,23 @@ dinotrace.txt: dinotrace.texi
$(MAKEINFO) -I$(srcdir) $(srcdir)/dinotrace.texi --output=$@ \
--no-headers --no-validate

INSTALL: install.texi
$(MAKEINFO) -I$(srcdir) $(srcdir)/install.texi --output=$@ \
--no-headers --no-validate
README.html: README.adoc

FAQ: faq.texi
$(MAKEINFO) -I$(srcdir) $(srcdir)/faq.texi --output=$@ \
--no-headers --no-validate
docs/FAQ.html: docs/FAQ.adoc

%.html: %.texi
perl html_texi_clean $*.texi >$*.tmp
perl docs/html_texi_clean $*.texi >$*.tmp
texi2html -monolithic $*.tmp
mv $*.tmp.html $*.html
rm $*.tmp

%.pdf: %.texi
perl docs/html_texi_clean $*.texi >$*.tmp
texi2pdf $*.tmp
rm $*.tmp

dvi: dinotrace.dvi

dinotrace.dvi: dinotrace.texi
@@ -210,7 +221,7 @@ configure:
@echo "This command is intended for maintainers to use;"
@echo "rebuilding the deleted files requires makeinfo."
rm -f *.info* $(INFOS) faq.html dinotrace.html configure bin/*
rm -f *.info* $(INFOS) FAQ.html FAQ.pdf dinotrace.html dinotrace.pdf configure bin/*

clean mostlyclean distclean maintainer-clean maintainer-copy::
for dir in $(SUBDIRS); do \
@@ -0,0 +1,146 @@
= Dinotrace

// Github doesn't render unless absolute URL

Dinotrace is a tool designed to aid in viewing Verilog Value Change Dump,
ASCII, Verilator, Tempest CCLI, COSMOS, Chango and Decsim Binary simulation
traces. It is optimized for rapid design debugging using X-Windows Mosaic.
A interface allows signal information to be annotated into source code
using Emacs.

Dinotrace is no longer under development, and has a somewhat outdated Motif
interface. It is however solid and reliable, and portability or other
serious issues are fixed when requested.

:toc: right

image:[license LGPLv3,link=]


Example screen shots:



== Linux Installation

Build using the GNU configuration process.

# Prerequisites
sudo apt-get install perl
# Obtain distribution kit
git clone
# Build
cd dinotrace
git pull
# Test
#export DISPLAY=:0.0 # If needed
./dinotrace traces/ascii.tra
# Install
make install

Dinotrace requires the Motif Widget set. If your system doesn't include
Motif, or OpenMotif, a public domain version, LessTif, is available at
@uref{}. Version 0.93.36 was known to work for this
release. Be sure to also have the LessTif and X11 development files
(header files) installed.

=== Supported Systems

Previous versions of Dinotrace were once built, and probably will still
build on:

* sparc-sun-solaris2.5.1
* i386-pc-linux
* i386-pc-cygwin32 (under Windows-2000 & Windows-XP)
* x86_64-suse-linux
* alpha-dec-osf4.0
* alpha-dec-vms6.0 (see the special section on VMS installation.)
* mips-dec-ultrix
* sparc-sun-sunos4.1.4
* vax-dec-vms6.0 (see the special section on VMS installation.)

=== Windows Installation

Dinotrace can be built for Windows under the Cygwin32 environment.

Dinotrace is still a X11 program, even under Windows-NT. Thus you must
add several packages to Cygwin.

* Install[Cygwin32]. You'll need the
gcc-g++, lesstif, make, and XFree96-prog (headers) packages. Generally
these aren't installed by default, use the Cygwin setup executable to get

* Obtain a X11 server. You can use XFree86 that came with cygwin. Another
alternative is the commercial @strong{eXcursion} or @strong{exceed}
programs. If using XFree86, you can start the server with @samp{xwin

* Make and install dinotrace using the instructions in the Linux section.

There are known problems in LessTif from looking at network drives in the
Dinotrace File Open requestor. You may want to specify trace files on the
command line instead of using the requestor.

==== VMS Installation

It's unlikely anyone is using VMS, but this is provided for historical

The `configure` program does not support Dinotrace, thus several
command files are supplied to build Dinotrace.

# Change to the download directory of dinotrace.
$ set default WHERE_DOWNLOADED
# Build Dinotrace with the file.
# If all was successful, you should be able to invoke the Dinotrace executable.
$ run dinotrace.exe

Create a logical to point to Dinotrace, and make a symbol to invoke
Dinotrace into the background. To do this, put in your group's
(Substituting in the appropriate directory for somedisk$.)

$! Dinotrace
$ define/group/nolog DINODISK somedisk$:[DINOTRACE]
$ arch_bin_v == "_VV"
$ if f$getsyi("NODE_HWTYPE") .eqs. "ALPH" then arch_bin_v == "_VA"
$ Dinotraceexe :== "$dinodisk:dinotrace''arch_bin_v'"
$ Dinotrace :== "spawn/nowait/nolog/input=nl:/output=nl: dinotraceexe"

Note a hazard with this definition of dinotrace: The display, etc. must be
set correctly for Dinotrace to start up. When running under VMS, if
Dinotrace has an error message when starting, it will not be seen due to
the spawn. To see error messages, users should be told to type:

$ dinotraceexe


See the documentation in `dinotrace.texi' or the equivalent[Dinotrace Manual PDF].

Also see the link:docs/FAQ.adoc[Dinotrace FAQ].


This package is Copyright 1992-2019 by Digital Equipment Corporation, and
Wilson Snyder <>.

Dinotrace is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 3, or (at your option) any later

Code created before 1998 was Copyrighted by Digital Equipment Corporation.
Their Copyright also disclaims any warranties, and disallows reproduction
for sale. Observing the GNU Copyleft should also cover this Copyright for
any software distributed not for a fee.
@@ -125,7 +125,7 @@ This file documents the Dinotrace package for signal waveform tracing.
This is edition @value{ID}, for Dinotrace version @value{VERSION}.

For the latest version, please see

Please feel free to send comments and suggestions to
@@ -163,7 +163,7 @@ simulation traces. It is optimized for rapid design debugging using
X-Windows Mosaic. A special interface allows signal information to be
annotated into source code using Emacs.

Please see the file @file{INSTALL} in the distribution directory for
Please see the file @file{README.adoc} in the distribution directory for
installation instructions.

@@ -2098,7 +2098,7 @@ rest of Dinotrace. If you encounter problems, you should return to this

You'll probably also need @file{verilog-mode.el} from
@uref{}. Make sure that file,
@uref{}. Make sure that file,
and the distribution's files @file{lisp/dinotrace.el} and
@file{lisp/sim-mode.el} are installed in your Emacs @code{site-lisp}
directory. (In Emacs @kbd{C-h v load-path @key{RET}} should list the

0 comments on commit 61810d6

Please sign in to comment.
You can’t perform that action at this time.