JS_OF_OCAML-LINK(1)

📦
version 6.2.0 · 4 versions
, in ubuntu resolute

okay bestie, listen up — this is the Js_of_ocaml linker, straight out of the Js_of_ocaml Manual. It's the js_of_ocaml link command and she is iconic 💅

✨ SYNOPSIS ✨

js_of_ocaml link [OPTION]… [JS_FILES]…

🦋 DESCRIPTION 🦋

So like, js_of_ocaml-link is a JavaScript linker. That's it, that's the job. She takes a bunch of JavaScript files and concatenates them into one — and the whole time she's keeping your sourcemap information intact. No cap. 🫶

🎀 ARGUMENTS 🎀

  • JS_FILES — the JavaScript files you want to link together. Just pass them, bestie. That's literally the assignment. 💖

👑 OPTIONS 👑

  • -a — build a library (a .cma.js file) out of the js files (the .cmo.js files) you dropped on the command line. It's giving ocamlc -a, fr fr. 🧚
  • --custom-header=VAL — give your generated JavaScript file a custom header. Lowkey the whole point is making your script executable with #!/usr/bin/env node 👀
  • --debug=SECTION — enable debug for SECTION. Turn it on, turn it up. 🔥
  • --debuginfo, --debug-info — output debug information. Two names, one vibe.
  • --disable=OPT — disable the optimization OPT. Not today, optimization. 💀
  • --empty-sourcemap, --empty-source-map — always generate empty source maps. Always. Periodt.
  • --enable=OPT — enable the optimization OPT. Yes queen, optimize. ✨
  • --linkall — link all compilation units. Every single one. She's thorough.
  • --no-sourcemap, --no-source-map — don't generate a source map at all. And heads up bestie — all other source map related flags will be ignored. Like, completely. 🙈
  • --noinline, --no-inline — disable inlining. Leave the functions where you found them. 🎀
  • -o FILE — set the output file name to FILE. Name your baby. 🍼
  • --pretty — pretty print the output. Because your code deserves to look good. 💅
  • -q, --quiet — suppress non-error messages. Shhh. Only the real problems get to speak. 🤫
  • --resolve-sourcemap-url=VAL (absent=false) — resolve the source map url. Note the default, bestie: absent=false.
  • --source-map-inline — inline the sourcemap directly into the generated JavaScript. All up in there. 🫶
  • --source-map-root=VAL — the root dir for the source map. 🌸
  • --sourcemap, --source-map — generate a source map. Yes. Do it. ⭐
  • --toplevel — compile a toplevel. Main character behavior tbh. 👑
  • -w WARN — enable or disable the warnings specified by the argument WARN. You're in charge of the warning situation. 🌈
  • --Werror — turn all warnings into errors. Every little warning? Now a whole error. Dramatic but valid. 💀

🌟 COMMON OPTIONS 🌟

  • --help[=FMT] (default=auto) — show this help in the format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined. (iykyk 🧚)
  • --version — show version information. The receipts, basically. 💖

🚦 EXIT STATUS 🚦

js_of_ocaml link exits with:

  • 0 — on success. Slay. ✨
  • 123 — on indiscriminate errors reported on standard error. 😭
  • 124 — on command line parsing errors. You typed something weird bestie. 💀
  • 125 — on unexpected internal errors (bugs). Not her fault, that's a bug. 🐛

🐛 BUGS 🐛

Bugs are tracked on github at https://github.com/ocsigen/js_of_ocaml/issues. Go tell them, they want to know. 🙈

👀 SEE ALSO 👀

💜 AUTHORS 💜

Jerome Vouillon, Hugo Heuzard. Legends, honestly. 🫶

📜 LICENSE 📜

Copyright (C) 2010-2020.

js_of_ocaml is free software, you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, with linking exception; either version 2.1 of the License, or (at your option) any later version. ✨

okay that's the whole page bestie, go link some JavaScript, you got this 💅

signed, sealed, delivered — this was Js_of_ocaml 6.2.0, page JS_OF_OCAML-LINK(1), mwah 🎀

📦 where this page comes from