hdoc/README.md

# hdoc

Emula um dos usos do mecanismo de "here doc" (didático). Equivale à linhas de comando como:

```
     here document
     ↓
cat << END > arquivo
```

Mas...

- Não utiliza uma palavra de término (termina com `Ctrl+D`);
- Por padrão, escreve apenas em novos arquivos (termina com erro se o arquivo existir);
- Com opções, a sobrescrita ou o *append* de arquivos existentes pode ser forçada.

## Como utilizar

```
Here Document (hdoc) 0.1

Uso: hdoc [OPÇÕES] ARQUIVO

Sem OPÇÕES, cria um novo ARQUIVO para receber linhas
digitadas no terminal.

OPÇÕES:
    -o    Força abertura de ARQUIVO para sobrescrevê-lo.
    -a    Força abertura de ARQUIVO para append.
    -h    Exibe esta ajuda.
```

## Como compilar

No diretório da sua escolha...

```
:~$ git clone https://bolha.dev/blau_araujo/hdoc.git
:~$ cd hdoc
:~/hdoc$ gcc -Wall -Wextra hdoc.c messages.c -o hdoc
```

O executável (`hdoc`) pode ser movido ou linkado para um diretório pessoal de executáveis ou para `/usr/local/bin`.

## Importante!

Este programa é apenas um exemplo didático para as pessoas que estão aprendendo C com o [Curso Básico da Linguagem C](https://www.youtube.com/playlist?list=PLXoSGejyuQGrDX08GVrQHAhh4j3KJ4iYN): use por sua conta e risco!