diff --git a/c64.asm b/c64.asm
index abda130..ef2f2ea 100644
--- a/c64.asm
+++ b/c64.asm
@@ -1,6 +1,3 @@
-; c64.asm - Useful dasm macros and definitions for C64 programs
-; will likely grow as I do more with the C64.
-; you can INCLUDE this file or just copy the parts you want.
 ; This file is CC0 (Public Domain)
 
 ; KERNAL functions
diff --git a/readme.md b/readme.md
index af90112..19153dd 100644
--- a/readme.md
+++ b/readme.md
@@ -1,8 +1,26 @@
 # dasm-c64
 
-macros and definitions for the c64 for the dasm 6502 assembler.
+macros and definitions for the C64 for the dasm 6502 assembler.
+will likely grow as I do more with the C64.
+you can INCLUDE this file or just copy the parts you want.
 
 ## Current contents
 
 * Definitions for all the KERNAL routines so they can be used by name (see https://www.c64-wiki.com/wiki/Kernal)
 * BasicUpstart macro: Writes a BASIC start script for the address provided as an argument.
+
+### Usage
+
+```
+	include "c64.asm"
+	processor 6502
+	org $0801
+	BasicUpstart init
+
+init:
+    ; Your program here
+```
+
+## Licence
+
+CC0