Date: Fri, 12 Feb 2021 18:23:17 +0100 From: Daniel Ebdrup Jensen <debdrup@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210212172317.msfh4wrb25penbhp@nerd-thinkpad.local> In-Reply-To: <CAFwocyOdSqnVUcRgUhiecXvG2qGasnL2VU0JugwEVc-WuvJxOg@mail.gmail.com> References: <20210210135028.u2mm3bhwgep557vu@nerd-thinkpad.local> <CAL2%2B-iWpZQi-x4cMLqCMuMH22REirEChP6__m%2B5gd_ZRBwqvGg@mail.gmail.com> <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> <CAFwocyNttBcOvyYVcs9Mp12bEmiWFCV3vWZCxnixc2QjmQ9%2ByA@mail.gmail.com> <c7d36625-0688-9ebb-de03-0e9b5eb55a82@freebsd.org> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> <YCZ4TedB5G1sI8L1@emphyrio.blackend.org> <CAFwocyOYepw%2BntThzGp8ZNKQrPHm9bzgK60_fpfu1BZ5v39y9Q@mail.gmail.com> <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> <CAFwocyOdSqnVUcRgUhiecXvG2qGasnL2VU0JugwEVc-WuvJxOg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--irzafdjvxnegornl Content-Type: text/plain; charset=utf-8; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Feb 12, 2021 at 06:16:30PM +0100, Sergio Carlavilla wrote: >On Fri, 12 Feb 2021 at 18:09, Daniel Ebdrup Jensen <debdrup@freebsd.org> >wrote: > >> On Fri, Feb 12, 2021 at 03:09:35PM +0100, Sergio Carlavilla wrote: >> >On Fri, 12 Feb 2021 at 13:45, Marc Fonvieille <blackend@freebsd.org> >> wrote: >> > >> >> Le 10.02.2021 17:03, Daniel Ebdrup Jensen a =C3=A9crit : >> >> > Yeah, I'm perfectly fine with doing it like how manual pages work, = ie. >> >> > the one-sentence-per-line workflow, if I understand it. >> >> > >> >> >> >> One sentence per line makes the read of diff/commit logs really >> >> difficult. I gave up reading the commit logs because of that. >> >> It's really a pain to find what changed without even talking about the >> >> edition of a long non-wrapped line in an editor. >> >> Some languages are very verbose, so we would end with very long lines. >> >> For a such change seems so backward. >> >> >> >> > I'll be re-working the handbook/x11 chapter to that at some point. = :) >> >> > >> >> >> >> Please don't. >> >> >> >> -- >> >> Marc >> >> >> >Hi, >> > >> >I know that this approach it=E2=80=99s causing some confusion with the = diffs >> tools. >> >But instead of using a different way that recommended from the AsciiDoc= tor >> >team I think we should try to focus on getting a solution in the diff >> tools. >> > >> >Maybe we can talk with the AsciiDoctor team. >> > >> >Bye. >> >> Hi folks, >> >> Marc does have a point, which I think is quite valid. A lot of people do >> reviews of code in the email they're sent, where - at least for the >> commits, it's inlined - and pursuant to discussions about this >> elsewhere, that doesn't seem likely to be changing any time soon. >> >> If diffs were attachments with the text/x-patch or text/x-diff >> mime-type, it'd be up to peoples MUA and possibly their .mailcap as to >> how it should be opened, but that's not something that's doable with the >> current setup. >> >> So I do think wrapping to 72 columns is the better option here, if we >> want to retain the broadest review possibilities. >> >> Yours, >> Daniel Ebdrup Jensen >> >Hi, > >Ok, if we use this approach. > >What are we gonna do with: > >Headings >Unordered list >Ordered list >Images >Include macro >AsciiDoc variables >Custom macros > >And I need to test classes and links. > >Bye. Hi folks, That's what we, in the business, call a good question. Won't the + syntax work for all of those markups? Yours, Daniel Ebdrup Jensen P.S. The business in question is the one for people with just a tiny clue stick. ;) --irzafdjvxnegornl Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAmuYVfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87rapQf+N4/sQhGi4JkWicszHxvWxediVOnRH/Nwc573Fe1u0V4jaWIe06Xmpzh2 W0IVMm31NZssTq2B5TdluU/AHh1PJ8ZvwV/w/QLxpBPUKNsZjLLE/whNwD0UsKzX oKc04KmBVtal4zYqaQP9NPK6wofNyQjdyBkW4bU3mLE022UaD1F5mezNmXintyeK BivvaAPm5EWGYKQ6J1w9ZurgCW4epnad4R6fCGKvErRh1er8vLvP/Z4+OzErtQM/ pt6qFlqDADxuSwCqbBvPTJHnaBMRgxHEELTJEGpGFEDeng557LJ6NCQo5Y38qOZE urZgMeGGt4nxa916dS5aasuJTrH6Kw== =Tx4M -----END PGP SIGNATURE----- --irzafdjvxnegornl--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210212172317.msfh4wrb25penbhp>