Annotation of src/usr.bin/file2c/file2c.1, Revision 1.1
1.1 ! downsj 1: .\"----------------------------------------------------------------------------
! 2: .\" "THE BEER-WARE LICENSE" (Revision 42):
! 3: .\" <phk@freebsd.org> wrote this file. As long as you retain this notice, you
! 4: .\" can do whatever you want with this file. If we meet some day, and you think
! 5: .\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
! 6: .\" ---------------------------------------------------------------------------
! 7: .\"
! 8: .\" $Id: file2c.1,v 1.1 1995/01/29 00:49:49 phk Exp $
! 9: .\"
! 10: .Dd Jan 28, 1995
! 11: .Dt FILE2C 1
! 12: .Os
! 13: .Sh NAME
! 14: .Nm file2c
! 15: .Nd convert file to c-source.
! 16: .Sh SYNOPSIS
! 17: .Nm file2c
! 18: .Op "string"
! 19: .Op "string"
! 20: .Sh DESCRIPTION
! 21: The
! 22: .Nm file2c
! 23: utility reads a file from stdin and writes it to stdout, converting each
! 24: byte to its decimal representation on the fly.
! 25: .Pp
! 26: If the first
! 27: .Op string
! 28: is present, it is printed before the data, if the second
! 29: .Op string
! 30: is present, it is printed after the data.
! 31: .Pp
! 32: This program is used to embedd binary or other files into C source files,
! 33: for instance as a char[].
! 34: .Sh EXAMPLE
! 35: The command:
! 36: .Bd -literal -offset indent
! 37: date | file2c 'const char date[] = {' ',0};'
! 38: .Ed
! 39: .Pp
! 40: will produce:
! 41: .Bd -literal -offset indent
! 42: const char date[] = {
! 43: 83,97,116,32,74,97,110,32,50,56,32,49,54,58,50,56,58,48,53,
! 44: 32,80,83,84,32,49,57,57,53,10
! 45: ,0};
! 46: .Ed
! 47:
! 48: