Work with documents¶

Open¶

muchado words                       # a new, empty document
muchado words ~/Documents/note.docx

Words opens one document per window, and multiple windows are not built yet — so a shell glob will be refused with an explanation rather than half-obeyed:

$ muchado words ~/Downloads/*.docx
muchado: 8 documents given; Words opens one.
  Multiple windows are not built yet -- see notes/02-specs.md.
  try: muchado words '/Users/you/Downloads/first.docx'

You can also open a document from inside the editor, through File ▸ Open.

Save¶

File ▸ Save writes back to the file you opened. Save as asks where to put it, and from then on that is the document you are editing.

Saving converts the editor's working format back into a real document, which takes about a second. Words can write .docx, .odt, .rtf and .txt.

Print¶

File ▸ Print, or the printer button, renders the document to PDF and opens it in your system's PDF viewer, where the print dialog lives.

This is deliberate for now: the viewer you already have gives you page ranges, paper size, scaling and a preview, none of which we would build better in the first version.

Images¶

Images embedded in a document are preserved on open and save. Insert ▸ Image adds one from a file.

Where your working files go¶

While a document is open, MuchAdo keeps a session directory alongside its application data. It holds the editor's working copy and a running log of your changes, which is what makes saving fast and undo reliable. It is not a backup, and it is not a place to look for your document — the document is where you saved it.