fix Makefile and README.md for 2013/misaka

Help `bf.pl` find perl and make executable.

2013/misaka/Makefile

@@ -1,196 +1,269 @@
 #!/usr/bin/env make
 #
-# 2013 makefile
+# IOCCC 2013 winning entry - misaka
+
+################################################################################
 #
-# This work by Landon Curt Noll, Simon Cooper, and Leonid A. Broukhis
+# Regarding individual entries:
-# is licensed under:
+#
+# IOCCC winning entry code may not work on your system.  Even with standards,
+# conditions and build environments change, especially when it comes to more
+# extreme code such you might find in an IOCCC winner.  Moreover, what was
+# allowed and liked in one IOCCC contest may no longer be liked/allowed in
+# later IOCCC years.
+#
+# Corrections on winning author and fixing typos in remarks are VERY WELCOME.
+#
+# GitHub pull requests are welcome:
+#
+# If you have a patch that might make running an entry work in modern Unix-like
+# environments, please create a GitHub pull request for the IOCCC judges to
+# consider.
+#
+# Suggestions and corrections regarding Makefiles, winning author information,
+# fixing typos in remarks, and code patches are welcome via opening a GitHub
+# issue or better yet, by creating a GitHub pull request for the IOCCC judges
+# to consider.  To form a GitHub issue or GitHub pull, please visit:
+#
+# https://github.com/ioccc-src/winner
+#
+################################################################################
+
+# This work by Landon Curt Noll and Leonid A. Broukhis is licensed under:
 #
 #	Creative Commons Attribution-ShareAlike 3.0 Unported License.
 #
 # See: http://creativecommons.org/licenses/by-sa/3.0/
 
 
-################
+#############################
-# tool locations
+# shell used by this Makefile
-################
+#############################
 #
 SHELL= bash
-CP= cp
+
-CPP= cpp
+#######################
-GUNZIP= gunzip
+# common tool locations
-LD= ld
+#######################
-MAKE= make
+#
-RM= rm
+include ../../var.mk
-SED= sed
-TAR= tar
-TRUE= true
-CHMOD= chmod
 
 # Set X11_LIBDIR to the directory where the X11 library resides
 #
-X11_LIBDIR= /usr/X11R6/lib
+#X11_LIBDIR= /usr/X11R6/lib
+#X11_LIBDIR= /usr/X11/lib
+X11_LIBDIR= /opt/X11/lib
 
 # Set X11_INCLUDEDIR to the directory where the X11 include files reside
 #
-X11_INCDIR= /usr/X11R6/include
+#X11_INCDIR= /usr/X11R6/include
+#X11_INCDIR= /usr/X11/include
+X11_INCDIR= /opt/X11/include
 
-# Compiler warnings
+# Common C compiler warnings to silence
 #
-#CWARN=
+#CSILENCE=
-CWARN= -Wall -W -Wno-comment -Wno-empty-body
+CSILENCE= -Wno-comment -Wno-empty-body
-#CWARN= -Wall -W -pedantic
 
-# compiler standard
+# Common C compiler warning flags
+#
+#CWARN= ${CSILENCE}
+#CWARN= -Wall ${CSILENCE}
+#CWARN= -Wall -Wextra ${CSILENCE}
+CWARN= -Wall -Wextra -pedantic ${CSILENCE}
+
+# Compiler standard
 #
 #CSTD=
 #CSTD= -ansi
-CSTD= -std=c99
+CSTD= -std=gnu11
 
-# compiler bit architecture
+# Compiler bit architecture
 #
 # Some entries require 32-bitness:
 # ARCH= -m32
 #
-# Some entries require 64-bitess:
+# Some entries require 64-bitness:
 # ARCH= -m64
 #
 # By default we assume nothing:
 #
 ARCH=
 
-# optimization
+# Defines that are needed to compile
+#
+CDEFINE=
+#CDEFINE= -DIOCCC
+
+# Include files that are needed to compile
+#
+CINCLUDE=
+#CINCLUDE= -include stdlib.h
+#CINCLUDE= -include stdio.h
+#CINCLUDE= -include stdlib.h -include stdio.h
+#CINCLUDE= -I ${X11_INCDIR} -I ${X11_INCDIR}/X11
+#CINCLUDE= `${SDL2_CONFIG} --cflags`
+
+# Optimization
 #
 # Most compiles will safely use -O2.  Some can use only -O1 or -O.
 # A few compilers have broken optimizers or this entry make break
 # under those buggy optimizers and thus you may not want anything.
+# Reasonable compilers will allow for -O3.
 #
 #OPT=
 #OPT= -O
 #OPT= -O1
-OPT= -O2
+#OPT= -O2
-#OPT= -O3
+OPT= -O3
+
+# Default flags for ANSI C compilation
+#
+CFLAGS= ${CSTD} ${CWARN} ${ARCH} ${CDEFINE} ${CINCLUDE} ${OPT}
 
 # Libraries needed to build
 #
 LIBS=
+#LIBS= -lm
+#LIBS= -L ${X11_LIBDIR} -lX11
+#LIBS= `${SDL2_CONFIG} --libs`
 
-# default flags for ANSI C compilation
+# C compiler to use
-#
-CFLAGS= ${CWARN} ${CSTD} ${ARCH} ${OPT} ${LIBS}
-
-# ANSI compiler
-#
-# Set CC to the name of your ANSI compiler.
-#
-# Some entries seem to need gcc.  If you have gcc, set
-# both CC and MAY_NEED_GCC to gcc.
-#
-# If you do not have gcc, set CC to the name of your ANSI compiler, and
-# set MAY_NEED_GCC to either ${CC} (and hope for the best) or to just :
-# to disable such programs.
 #
 CC= cc
 #CC=clang
-MAY_NEED_GCC= gcc
+#CC=gcc
+
+# Compiler add-ons or replacements for clang only
+#
+ifeq ($(CC),clang)
+#
+CSILENCE+= -Wno-documentation -Wno-format-nonliteral -Wno-missing-prototypes \
+	-Wno-missing-variable-declarations -Wno-poison-system-directories \
+	-Wno-shorten-64-to-32 -Wno-sign-conversion \
+	-Wno-unreachable-code-loop-increment -Wno-unused-macros
+#
+CWARN+= -Weverything
+#
+endif
+
+# Specific add-ons or replacements for gcc only
+#
+ifeq ($(CC),gcc)
+#
+#CSILENCE+=
+#
+#CWARN+=
+#
+endif
 
 
 ##############################
 # Special flags for this entry
 ##############################
 #
-ENTRY= horizontal_cat vertical_cat long_cat loong_cat \
+ENTRY= misaka
+PROG= ${ENTRY}
+#
+OBJ= misaka.o misaka2.o misaka3.o misaka4.o misaka5.o \
+        misaka6.o misaka7.o misaka8.o misaka9.o
+DATA= bf.pl spoiler.html
+TARGET= ${PROG} horizontal_cat vertical_cat long_cat loong_cat \
 	loooong_cat loooooooong_cat long_fat_cat \
 	long_faat_cat same_as_long_cat
-OBJS= misaka.o misaka2.o misaka3.o misaka4.o misaka5.o \
+#
-	misaka6.o misaka7.o misaka8.o misaka9.o
+ALT_OBJ=
+ALT_TARGET=
+
 OTHER_C= misaka2.c misaka3.c misaka4.c misaka5.c \
 	misaka6.c misaka7.c misaka8.c misaka9.c
-DATA= bf.pl
-ALT_OBJ=
-ALT_ENTRY=
 
 
 #################
 # build the entry
 #################
 #
-all: ${ENTRY} ${DATA}
+all: data ${TARGET}
 	@${TRUE}
 
-misaka: all
+.PHONY: all alt data everything clean clobber install \
-	@${TRUE}
+	love haste waste maker easter_egg sandwich \
+	supernova deep_magic magic charon pluto
 
-horizontal_cat: misaka.c
+${PROG}: ${PROG}.c
-	${CC} ${CFLAGS} $< -o $@
+	${CC} ${CFLAGS} $< -o $@ ${LIBS}
 
-misaka2.c: horizontal_cat misaka.c
+horizontal_cat: ${PROG}.c
-	${RM} -f misaka2.c
+	${CC} ${CFLAGS} $< -o $@ ${LIBS}
-	./horizontal_cat misaka.c misaka.c > misaka2.c
 
-vertical_cat: misaka2.c
+${PROG}2.c: horizontal_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka2.c -o $@
+	${RM} -f $@
+	./horizontal_cat ${PROG}.c ${PROG}.c > $@
 
-misaka3.c: vertical_cat misaka.c
+vertical_cat: ${PROG}2.c
-	${RM} -f misaka3.c
+	${CC} ${CFLAGS} ${PROG}2.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c > misaka3.c
 
-long_cat: misaka3.c
+${PROG}3.c: vertical_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka3.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c > $@
 
-misaka4.c: vertical_cat misaka.c
+long_cat: ${PROG}3.c
-	${RM} -f misaka4.c
+	${CC} ${CFLAGS} ${PROG}3.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c misaka.c > misaka4.c
 
-loong_cat: misaka4.c
+${PROG}4.c: vertical_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka4.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c ${PROG}.c > $@
 
-misaka5.c: vertical_cat misaka.c
+loong_cat: ${PROG}4.c
-	${RM} -f misaka5.c
+	${CC} ${CFLAGS} ${PROG}4.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c misaka.c misaka.c > misaka5.c
 
-loooong_cat: misaka5.c
+${PROG}5.c: vertical_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka5.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c ${PROG}.c ${PROG}.c > $@
 
-misaka6.c: vertical_cat misaka.c
+loooong_cat: ${PROG}5.c
-	${RM} -f misaka6.c
+	${CC} ${CFLAGS} ${PROG}5.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c misaka.c misaka.c misaka.c > misaka6.c
 
-loooooooong_cat: misaka6.c
+${PROG}6.c: vertical_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka6.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c ${PROG}.c ${PROG}.c ${PROG}.c > $@
 
-misaka7.c: vertical_cat horizontal_cat misaka.c
+loooooooong_cat: ${PROG}6.c
-	${RM} -f misaka7.c
+	${CC} ${CFLAGS} ${PROG}6.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c | ./horizontal_cat - - > misaka7.c
 
-long_fat_cat: misaka7.c
+${PROG}7.c: vertical_cat horizontal_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka7.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c | ./horizontal_cat - - > $@
 
-misaka8.c: vertical_cat horizontal_cat misaka.c
+long_fat_cat: ${PROG}7.c
-	${RM} -f misaka8.c
+	${CC} ${CFLAGS} ${PROG}7.c -o $@ ${LIBS}
-	./vertical_cat misaka.c misaka.c | ./horizontal_cat - - - > misaka8.c
 
-long_faat_cat: misaka8.c
+${PROG}8.c: vertical_cat horizontal_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka8.c -o $@
+	${RM} -f $@
+	./vertical_cat ${PROG}.c ${PROG}.c | ./horizontal_cat - - - > $@
 
-misaka9.c: vertical_cat horizontal_cat misaka.c
+long_faat_cat: ${PROG}8.c
-	${RM} -f misaka9.c
+	${CC} ${CFLAGS} ${PROG}8.c -o $@ ${LIBS}
-	./horizontal_cat misaka.c misaka.c | ./vertical_cat misaka.c - > misaka9.c
 
-same_as_long_cat: misaka9.c
+${PROG}9.c: vertical_cat horizontal_cat ${PROG}.c
-	${CC} ${CFLAGS} misaka9.c -o $@
+	${RM} -f $@
+	./horizontal_cat ${PROG}.c ${PROG}.c | ./vertical_cat ${PROG}.c - > $@
 
-# Information on the misaka programs
+same_as_long_cat: ${PROG}9.c
+	${CC} ${CFLAGS} ${PROG}9.c -o $@ ${LIBS}
+
+# Information on the ${PROG} programs
 #
-understanding: bf.pl misaka.c ${OTHER_C}
+understanding: bf.pl ${PROG}.c ${OTHER_C}
 	@${CHMOD} +x bf.pl
-	@for c in misaka.c ${OTHER_C}; do \
+	@for c in ${PROG}.c ${OTHER_C}; do \
 	    echo ./bf.pl $$c; \
 	    ./bf.pl $$c; \
 	done
 
 # alternative executable
 #
-alt: ${ALT_ENTRY}
+alt: data ${ALT_TARGET}
 	@${TRUE}
 
 # data files
@@ -198,34 +271,51 @@ alt: ${ALT_ENTRY}
 data: ${DATA}
 	@${TRUE}
 
+# both all and alt
+#
+everything: all alt
+
 
 ###############
 # utility rules
 ###############
 #
-everything: all alt
-
 clean:
-	${RM} -f ${OBJS} ${ALT_OBJ}
+	${RM} -f ${OBJ} ${ALT_OBJ}
+	@-if [ -f indent.c ]; then \
+	    echo ${RM} -f indent.c; \
+	    ${RM} -f indent.c; \
+	fi
 
 clobber: clean
-	${RM} -f ${ENTRY} ${ALT_ENTRY}
+	${RM} -f ${TARGET} ${ALT_TARGET}
-	${RM} -f ${OTHER_C}
+	@-if [ -e sandwich ]; then \
-
+	    ${RM} -f sandwich; \
-nuke: clobber
+	    echo 'ate sandwich'; \
-	@${TRUE}
+	fi
-
-dist_clean: nuke
-	@${TRUE}
 
 install:
-	@echo "Surely we are joking Dr. Lehmer!"
+	@echo "Dr. Spock says that is not logical!"
 	@${TRUE}
 
-# backwards compatibility
+# you may be able to misunderstand the source by reading indent.c
 #
-build: all
+indent.c: ${PROG}.c
-	@${TRUE}
+	@if which "${GINDENT}" >/dev/null 2>&1; then \
+	    echo ${RM} -f $@; \
+	    ${RM} -f $@; \
+	    echo "${GINDENT} < $< > $@"; \
+	    ${GINDENT} < $< > $@; \
+	elif which "${INDENT}" >/dev/null 2>&1; then \
+	    echo ${RM} -f $@; \
+	    ${RM} -f $@; \
+	    echo "${INDENT} < $< > $@"; \
+	    ${INDENT} < $< > $@; \
+	else \
+	    echo "no intent tool found, ident $< yourself, sorry"; \
+	    echo "exit 1"; \
+	    exit 1; \
+	fi
 
 
 ##################
@@ -244,35 +334,69 @@ waste:
 	@echo 'haste'
 	@${TRUE}
 
+maker:
+	@echo 'Participate in a maker faire'
+	@${TRUE}
+
 easter_egg:
-	@echo you expected to mis-understand this $${RANDOM} magic
+	@echo "you expected to often misunderstand this $${RANDOM} magic"
-	@echo chongo '<was here>' "/\\oo/\\"
+	@echo "chongo '<was here>' /\\oo/\\"
-	@echo Readers shall not be disallowed from being unable to not partly misunderstand this partocular final echo.
+	@echo "Eggy"
+
+sandwich: easter_egg
+	@if [ `id -u` -eq 0 ]; then \
+	    echo 'Okay.'; \
+	    echo "$${RANDOM}`date +%s`$${RANDOM}" > $@; \
+	else \
+	    echo 'What? Make it yourself.'; \
+	    exit 1; \
+	fi
 
 # Understand the history of the Homebrew Computer Club
 # as well as the West Coast Computer Faire and
 # you might be confused different.  :-)
 #
-supernova: nuke
+supernova: sandwich
 	@-if [ -r .code_anal ]; then \
-	    ${RM} -f .code_anal_v4; \
+	    ${RM} -f .code_anal_v6; \
 	else \
-	    echo "We are not expected to understand that"; \
+	    echo "planet deniers, like some members of the IAU, are so cute when they try to defend their logic"; \
 	fi
+	@echo "A $@ helps ${MAKE} the elements that help form planets"
 	@${TRUE}
 
-deep_magic:
+deep_magic: supernova
 	@-if [ -r .code_anal ]; then \
-	    ccode_analysis --deep_magic 2ed3582ec5c094a093fea2a6bcb9f19439892873c9cc45ed1ceaafe08b7d52e1b2c7cd524be3b0b2 --FNV1a_hash 512-bit "${ENTRY}"; \
+	    ccode_analysis --deep_magic 7889066cdbdf09b0408021754586e895be641cc9be29e7eafd3ca65359541f17 \
+	    		   --FNV1a_hash_512_bit -v2 "${PROG}" "${PROG}.c"; \
 	else \
-	    echo "Park different"; \
+	    echo "Wrong! Do it again!"; \
+	    sleep 2; \
+	    echo "Wrong! Do it again!"; \
+	    sleep 2; \
+	    echo "Wrong! Do it again!"; \
 	fi
 	@${TRUE}
 
 magic: deep_magic
 	@-if [ -r .code_anal ]; then \
-	    ccode_analysis --mode 391581 --level 216193 --FNV1a_hash 512-bit "${ENTRY}"; \
+	    ccode_analysis --level 20003 --mode 5717175 --FNV1a_hash_512_bit -v2 "${PROG}" "${PROG}.c"; \
 	else \
-	    echo "These aren't the primes you're looking for Paul Erdos!"; \
+	    echo "If you don't eat yer meat, you can't have any pudding!"; \
+	    echo "How can you have any pudding if you don't eat yer meat?!"; \
 	fi
 	@${TRUE}
+
+# The IOCCC resident astronomer states
+#
+charon: magic
+	@echo "$@ is a dwarf planet"
+	@echo "dwarf is a type of planet"
+	@echo "therefore IAU, $@ is a planet"
+
+pluto: charon
+	${MAKE} charon
+	@echo "$@ is a dwarf planet"
+	@echo "dwarf is a type of planet"
+	@echo "therefore, $@ is a planet"
+	@echo "having lots of planets is good feature because supernovae can help ${MAKE} a lot of them"

2013/misaka/README.md

@@ -4,29 +4,32 @@ Don Yang
     <omoikane@uguu.org>  
     <http://uguu.org/>  
 
+# To build:
 
-## Judges' comments:
+```sh
-### To build:
+make
-
+```
-    make misaka
 
 This will build a bunch of versions of the code. See the author's details for information on all of these builds.
 
-To understand the various intermediate source files that are built, try:
-
-    make understanding
-
 ### To run:
 
+```sh
 ./horizontal_cat [files...] > [output]
 ./vertical_cat [files...] > [output]
-
+```
-NOTE: Use - for standard input.  For example:
-
-    ./vertical_cat - -
 
 ### Try:
 
+To understand the various intermediate source files that are built, try:
+
+```sh
+make understanding
+```
+
+Also try:
+
+```sh
 seq 1 12 | ./horizontal_cat - - -
 
 ./long_cat
@@ -37,8 +40,15 @@ NOTE: Use - for standard input.  For example:
 ./loooooooong_cat
 
 seq -f '%.0f  ' 45 | ./horizontal_cat - misaka.c
+```
 
-### Selected Judges Remarks:
+NOTE: Use - for standard input.  For example:
+
+```sh
+./vertical_cat - -
+```
+
+## Judges' comments:
 
 There is more to cat than [mere cats](http://cheezburger.com/1680494336).  
 Be they tall, fat, long or squat, this source code is sure to amuse.
@@ -61,26 +71,27 @@ the flying fish was returned to *em*swim with the fishes*em*. :-)
 No cats were harmed in the process of judging this entry.
 
 ## Author's comments:
-Overview
+
-========
+### Overview
+
 Misaka is a file concatenation utility, with at least two modes of
 operation:
 
-    gcc misaka.c -o horizontal_cat
+```sh
+cc misaka.c -o horizontal_cat
 ./horizontal_cat [files...] > [output]
 
 ./horizontal_cat misaka.c misaka.c > misaka2.c
-    gcc misaka2.c -o vertical_cat
+cc misaka2.c -o vertical_cat
 ./vertical_cat [files...] > [output]
+```
 
 Where [files...] are a list of text file names.  Use "-" to read from stdin.
 
+### Details
 
-Details
+### Horizontal cat
-=======
 
-Horizontal cat
---------------
 One of my favorite unix utilities is *cat*.  The best thing about it was
 that it was named "cat".  That, and it's useful for quickly showing contents
 of a file.  Though it was primary meant for concatenating files, that
@@ -89,8 +100,10 @@ function only seem to work if I wanted to concatenate files vertically.
 I thought the lack of horizontal concatenation must have been an oversight,
 so I implemented this utility:
 
-    gcc misaka.c -o horizontal_cat
+```sh
+cc misaka.c -o horizontal_cat
 ./horizontal_cat files...
+```
 
 *horizontal_cat* concatenates files horizontally and write the output to
 stdout.  Each input file is padded with spaces on the right so that the
@@ -102,11 +115,12 @@ can specify "-" multiple times to get stdin multiplied horizontally.  For
 example, if you have seq(1) in your shell, you can add line numbers to both
 sides of misaka.c like this:
 
+```sh
 seq -f '  %.0f  ' 45 | ./horizontal_cat - misaka.c -
+```
 
+### Vertical cat
 
-Vertical cat
-------------
 Because *horizontal_cat* must know the maximum width of all files before
 writing any output, all files must be processed at least twice.  To support
 stdin, file must be buffered to memory.  This lead to the feature that
@@ -117,30 +131,36 @@ files vertically, so I included a vertical mode.  But supporting vertical
 mode with command line options would be no fun.  Instead, vertical mode is
 enabled by concatenating the source code horizontally:
 
+```sh
 ./horizontal_cat misaka.c misaka.c > misaka2.c
 gcc misaka2.c -o vertical_cat
 ./vertical_cat files...
+```
 
 *vertical_cat* works more or less like *cat*, except you can use
 *vertical_cat* to duplicate stdin:
 
+```sh
 ./vertical_cat - -
+```
 
+### Long cat
 
-Long cat
---------
 After *horizontal_cat* and *vertical_cat*, I thought, maybe all I really
 wanted was just more cats.  So I implemented one more mode, this one is
 enabled by concatenating misaka.c vertically:
 
+```sh
 ./vertical_cat misaka.c misaka.c > misaka3.c
 gcc misaka3.c -o long_cat
 ./long_cat
+```
 
 *long_cat* outputs ASCII art of a cat to stdout.  You can make this cat
 exponentially longer by concatenating more files vertically (up to 31 levels
 high, depending on sizeof(int) for your compiler):
 
+```sh
 ./vertical_cat misaka.c misaka.c misaka.c > misaka4.c
 gcc misaka4.c -o loong_cat
 
@@ -149,36 +169,42 @@ high, depending on sizeof(int) for your compiler):
 
 ./vertical_cat misaka.c misaka.c misaka.c misaka.c misaka.c > misaka6.c
 gcc misaka6.c -o loooooooong_cat
+```
 
 If your terminal has really thin fonts, you can also make this output fatter
 by concatenating files horizontally:
 
+```sh
 ./vertical_cat misaka.c misaka.c | ./horizontal_cat - - > misaka7.c
 gcc misaka7.c -o long_fat_cat
 
 ./vertical_cat misaka.c misaka.c | ./horizontal_cat - - - > misaka8.c
 gcc misaka8.c -o long_faat_cat
+```
 
 Output width is determined by the first level of stacked programs, so a
 triangle like the following will not have horizontally expanded output:
 
+```sh
 ./horizontal_cat misaka.c misaka.c | ./vertical_cat misaka.c - > misaka9.c
 gcc misaka9.c -o same_as_long_cat
+```
 
 Finally, if you lost track of how many misaka.c you have stacked together,
 you can feed the source to a brainfuck interpreter to get a overview of how
 the programs are stacked.  Example:
 
+```sh
 perl bf.pl misaka9.c
+```
 
 This outputs:
 
     MISAKA
     MISAKA MISAKA
 
+### Return value
 
-Return value
-============
 *horizontal_cat* and *vertical_cat* will exit with zero status on success.
 
 If any input file fails to open, *horizontal_cat* and *vertical_cat* will
@@ -187,9 +213,8 @@ report the offending file name to stdout, and exit with nonzero status.
 If *horizontal_cat* and *vertical_cat* ran out of memory, they will exit
 with nonzero status without outputting anything.
 
+### Compatibility
 
-Compatibility
-=============
 *horizontal_cat* makes the following assumptions about input files:
 
    * ASCII with LF end of line sequences.  If CR-LF sequences are used, CR
@@ -207,9 +232,8 @@ combinations:
 Misaka requires a C99 compiler due to the use of single line comments.
 Misaka does not depend on any other C99 features.
 
+### Obfuscation
 
-Obfuscation
-===========
 Main obfuscation is in having a C program that compiles when tiled
 horizontally and vertically, while using single line comments in less than
 half of the lines.  *And* maintaining a meaningful layout while doing that.
@@ -229,29 +253,26 @@ Other features to look for:
 "gcc -Wall" should provide a hint to where the mode switch happens, it
 does not output any irrelevant other warnings (verified on 4.6.3).
 
+### Extra files
 
-Extra files
-===========
 Extra files included in my submission are informational only, they are not
 needed for the program to work.
 
    * bf.pl = a brainfuck interpreter, in case if you don't have one handy.
    * spoiler.html = making of this program.
 
+### About Misaka
 
-About Misaka
-============
 The name, layout, and functionality of Misaka is inspired by a particular
 stackable figure:
 
    * [Google images](http://google.co.jp/search?q=%E3%83%9F%E3%82%B5%E3%82%AB%E7%9B%9B%E3%82%8A&tbm=isch)
    * [Kotobukiya](http://main.kotobukiya.co.jp/figure/tsubucole_tmi_misakamori/)
 
---------------------------------------------------------------------------------
+## Copyright:
-<!--
+
 (c) Copyright 1984-2015, [Leo Broukhis, Simon Cooper, Landon Curt Noll][judges] - All rights reserved
 This work is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported License][cc].
 
 [judges]: http://www.ioccc.org/judges.html
 [cc]: http://creativecommons.org/licenses/by-sa/3.0/
--->

2013/misaka/bf.pl

@@ -1,4 +1,4 @@
-#!/usr/bin/perl -w
+#!/usr/bin/env perl -w
 #
 # Usage:
 #  ./bf.pl [-e <file.txt>] [-d] <program>