Skip to content

thgie/critical-reading-vice

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Critical reading VICE

This is the repository of the scripts that were used in helping in an attempt of critically reading the VICE1 source code.

VICE is a program that runs on a Unix, MS-DOS, Win32, OS/2, BeOS, QNX 4.x, QNX 6.x, Amiga, Syllable or Mac OS X machine and executes programs intended for the old 8-bit computers.

More information on this analysis can be found under https://jache.re/notes/VICE.

Setup

  1. Download the source distribution from https://vice-emu.sourceforge.io/index.html#download 2 and extract to vice-source-code in this folder
  2. Copy all files ending in *.c and *.h from the downloaded archive's src folder to this repository's src folder
    • Flatten the hierarchy in the repository's src folder, no subfolders
    • Either do that manually or execute scripts/01-prepare-corpus.sh
  3. You are now able to execute the python scripts

Scripts

  • scripts/02-split.py splits the provided source code files into files with either just comments or just code, and moves them to the appropriate subfolders. This helps if you want to have a dataset with just one of the two textual elements.
  • scripts/03-vice-network.py generates a CSV file with the relations between files and their authors. The CSV is meant to be imported in Gephi after.
  • scripts/04-authors-network.py generates a CSV file with the relations between files according to their #include statements. Also meant to be imported in Gephi after.

Footnotes

  1. https://vice-emu.sourceforge.io/

  2. I originally used the 3.9 release