README

Overview

This set of directories and files mirrors the contents of https://j3-fortran.org, maintained by Steve Lionel, the ISO WG5 convenor. This web site is the system of record for papers presented and discussed by the INCITS Fortran and ISO WG5 Fortran standards groups.

papers/

Each paper or document in j3-fortran.org has a corresponding file in the papers directory. Having these all in one directory makes it easier to search through them than when they are in multiple directories.

years/

The j3-fortran web site organizes papers by year and by meeting. The years directory in this repository holds the papers for each 4-digit year. The files in the years directories are symlinks to the documents in the papers directory.

meetings/

The meetings directory in this repository contains a directory for each meeting (padded to 3 digits). The documents for each meeting are symlinks to the documents in the papers directory.

file-types

The results of running the file command on each of the files in the papers directory. We use this to identify file with odd (non-ASCII, non-UTF-8) character encodings.

Makefile

Contains commands to make the INDEX and file-types targets.

bin commands

There are commands in the bin directory to maintain this repository.

bin/fetch-docs-for-meeting

Given a meeting number nnn (or an entry in the meetings directory), pull all the meeting files, and place the real files in the years directory, and a link to that file in the meetings/nnn and papers directory.

No cleanup of non-ASCII text is done on the fetch.

bin/fetch-docs-for-meeting 226           # Fetch all meeting 226 documents
bin/fetch-docs-for-meeting meetings/226  # This does the same thing

bin/fetch-docs-for-meeting meetings/*     # Fetch documents for all meetings

Useful options:

-v

Be verbose about the actions taken.

-vv

Add debug output tn the verbose output.

bin/cleanup-text

This commands cleans up files in papers. A variety of cleanup can be done on the text files:

• Making line endings consistent (LF instead of CR or CRLF)
• Removing excess whitespace at the ends of lines
• Removing excess blank lines at the ends of files
• Replace Windows-1252 extended-ASCII with UTF-8 equivalents
• Replace ISO-8859 extended-ASCII with UTF-8 equivalents
• Replace Code Page 437 characters with UTF-8 equivalents
• Replace other strange character encodings with UTF-8 equivalents (^G for bullets, \x{FF}2D for +, and others that defy explanation)

bin/cleanup-*

These other commands typically clean up one specific kind of text change in a file (e.g., CRLF –> LF transformation, or ^R, ^S, ^T to curly apostrophes and quotes).

bin/wheres

Given a document prefix, identify all the locations of the document in papers, meetings, and years.

$ bin/wheres S8
S8:
  S8.102.pdf	meetings/102/S8.102.pdf
  S8.102.pdf	papers/S8.102.pdf
  S8.102.pdf	years/1986/S8.102.pdf
  S8.103.pdf	meetings/103/S8.103.pdf
  S8.103.pdf	papers/S8.103.pdf
  S8.103.pdf	years/1987/S8.103.pdf
  S8.104.pdf	meetings/104/S8.104.pdf
  S8.104.pdf	papers/S8.104.pdf
  S8.104.pdf	years/1987/S8.104.pdf
  S8.111.pdf	meetings/111/S8.111.pdf
  S8.111.pdf	papers/S8.111.pdf
  S8.111.pdf	years/1989/S8.111.pdf
  S8.114.pdf	meetings/114/S8.114.pdf
  S8.114.pdf	papers/S8.114.pdf
  S8.114.pdf	years/1990/S8.114.pdf
  S8.115.pdf	meetings/115/S8.115.pdf
  S8.115.pdf	papers/S8.115.pdf
  S8.115.pdf	years/1990/S8.115.pdf
  S8.99.pdf	meetings/099/S8.99.pdf
  S8.99.pdf	papers/S8.99.pdf
  S8.99.pdf	years/1986/S8.99.pdf

$ bin/wheres 22-124
22-124:
  22-124.txt	meetings/226/22-124.txt
  22-124.txt	papers/22-124.txt
  22-124.txt	years/2022/22-124.txt
  22-124r1.txt	meetings/226/22-124r1.txt
  22-124r1.txt	papers/22-124r1.txt
  22-124r1.txt	years/2022/22-124r1.txt
  22-124r2.txt	meetings/226/22-124r2.txt
  22-124r2.txt	papers/22-124r2.txt
  22-124r2.txt	years/2022/22-124r2.txt

bin/make-index

Creates the INDEX file used by bin/wheres. For each file, it contains

• The file’s base name (e.g., 00-000.txt)
• The file’s line count if it is a .txt file; otherwise n/a
• The file’s md5 hash
• A location in the meetings, papers, or years directory